v1.0.0 Phase 1 Complete

Contact Engine
Phase 1: The Local Client

A local-first, highly performant desktop contact manager. Phase 2 will introduce a FastAPI cloud sync backend.

⚡ Completed Tier 1 Project (October 2026).

~ System Architecture

~ Architecture Trailer

~ About the Project

Contact Engine is a PySide6 desktop application that operates entirely offline. It utilizes a local SQLite database with Write-Ahead Logging (WAL) and a Full-Text Search (FTS5) inverted index.

Following strict Model-View-Controller (MVC) architecture, it features a custom QAbstractTableModel, dockable UI panels, 200ms debounced search, and a comprehensive test suite of 64 tests covering UI, database, and E2E workflows.

Roadmap: Phase 1 (Current) is the offline-first desktop client. Phase 2 will introduce a FastAPI backend, Async SQLAlchemy, and client-server synchronization.

~ Tech Stack & Architecture

Python 3.10+ PySide6 (Qt) SQLite (WAL & FTS5) pytest-qt MVC Pattern

~ How to Run

Option 1: Standalone Executable

Download contact_engine_v1.0.zip below, extract it, and double-click ContactEngine.exe.

⚠️ Note: Because this is an unsigned indie app, Windows SmartScreen may show a "Windows protected your PC" warning. Click More info and Run anyway.

Option 2: From Source

1. Clone the repo and install dependencies:

git clone https://github.com/Tharana-Dev/Contact-Engine.git
cd Contact-Engine
pip install PySide6

2. Run the app:

python main.py

3. Run the 64 automated tests:

pytest -v

~ Want to try it?

Download the executable or the source code, test out the search and export features, and let me know your thoughts!

Download Phase 1 App (.exe) ⬇ Download Source ⬇ Email ideas →

Contact Engine Phase 1: The Local Client