Metadata-Version: 2.4
Name: cryptor-app
Version: 0.0.100
Summary: An offline, zero-trust cryptographic notebook with local async AI utilities.
Author-email: Mapenzi Mudimba <mudimbam@outlook.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/mapenzim/cryptor_app
Project-URL: Bug Tracker, https://github.com/mapenzim/cryptor_app/issues
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: ollama>=0.2.0
Requires-Dist: pycryptodome>=3.18.0
Dynamic: license-file

# Cryptor App 🔐

An isolated, multi-user secure text editor featuring robust application file encryption utilizing AES/RSA algorithms, dynamic token-based session tracking, and seamless SQLite database backend synchronization.

## 🚀 Getting Started

Follow these instructions to set up a local copy of the project and get it running on your machine.

### 📋 Prerequisites

Ensure you have **Python 3.11** or higher installed on your system. You can check your version by running:

```bash
python --version

```

---

## 🛠️ Installation & Setup

This application features an **automated setup environment**. The custom startup engine will handle directory generation, schema configuration, and visual package installation automatically on its first run!

### 1. Clone the Repository

Clone the project structure down to your local directory:

```bash
git clone [https://github.com/YOUR_USERNAME/cryptor_app.git](https://github.com/YOUR_USERNAME/cryptor_app.git)
cd cryptor_app

```

### 2. Create a Virtual Environment (Recommended)

Isolate your package scope from your global system environment variables:

**On Windows:**

```bash
python -m venv venv
source venv/Scripts/activate

```

**On macOS/Linux:**

```bash
python3 -m venv venv
source venv/bin/activate

```

### 3. Launch the Application

Once your environment is active, you don't need to manually install dependencies using pip. Simply boot up the entry file:

```bash
python main.py

```

---

## 📦 Under the Hood: First-Boot Lifecycle

When you initialize `main.py` for the first time, the application safely triggers a background pipeline:

1. **Dependency Engine Gating:** The interpreter checks if the modern cryptographic layout `pycryptodome` is present inside the virtual environment.
2. **Determinate Progress Bar:** If missing, a standalone Tkinter loading bar pops up, safely installing the library package using an asynchronous worker thread while providing smooth percentage tracking metrics up to 100%.
3. **Database Directory Carving:** The connection routine evaluates your structural file trees, automatically carving out the missing `./db/` storage directory if it doesn't exist.
4. **Schema Initialization:** SQLite builds and verifies your secure transaction schemas (`users`, `cookies`, `lockedfiles`, `keys`) using fail-safe `IF NOT EXISTS` transaction loops.
5. **Lazy Loading Runtime Execution:** Database and cryptographic evaluation points are deferred safely until the verification loops pass—allowing the application login panels to draw cleanly with zero system warning outputs.

---

## 🧹 Contributing Guardrails (`.gitignore`)

To protect local environments and security parameters from leaking onto remote version control trees, the repository ignores runtime binary clutter. Ensure your tracking scope complies with our `.gitignore` filters:

* Do **NOT** push local configuration binaries or platform optimization wrappers (`__pycache__/`, `.pyc`, `.vscode/`).
* Do **NOT** push active virtual environments (`venv/`).
* Do **NOT** push structural session binaries, database caches, or security instances (`db/`, `*.db`).


### Pro Tip for Updating Your Repo
Before committing this documentation template, make sure your dependency references match your current working tree environment by generating a requirements index file inside your Git Bash console:

```bash
pip freeze > requirements.txt
git add .gitignore README.md requirements.txt
git commit -m "docs: implement robust first-boot documentation and tracking guardrails"
git push origin main

```
