cryptor-app 0.0.100

An offline, zero-trust cryptographic notebook with local async AI utilities.

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:

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:

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:

python -m venv venv
source venv/Scripts/activate

On macOS/Linux:

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:

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:

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