To understand a necessity of this age, Money!
Kuber is an enterprise-grade, offline, privacy-focused personal wealth management and double-entry accounting desktop suite for Windows. Designed to provide speed, clarity, and total data sovereignty without third-party cloud servers, monthly subscription fees, or data telemetry, Kuber combines rigorous financial engineering with a state-of-the-art desktop user interface and an interactive web distribution portal.
We have prepared an exhaustive, standard software engineering technical documentation file detailing every architectural decision, folder structure, database schema, and file-by-file breakdown.
👉 Read the Full Documentation here: PROJECT_DOCUMENTATION.md 👈
- Windows 10 or 11 (64-bit)
- Python 3.10, 3.11, or 3.12 installed and in your system
PATH. - Git installed on your workstation.
Open PowerShell or Terminal in your desired folder:
# Clone the repository
git clone https://github.com/Aarya-Shinde/Kuber.git
cd Kuber
# Allow script execution for the current PowerShell session (if required)
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process
# Create and activate virtual environment
python -m venv venv
.\venv\Scripts\Activate.ps1# Install required Python libraries (PyQt6, WebEngine, SQLAlchemy)
pip install -r requirements.txt
# Run Kuber in developer mode
python main.py- 🏛️ True Double-Entry Accounting: Multi-split transaction allocations across bank accounts, credit cards, income sources, and asset holdings.
- 🔒 100% Offline & 256-Bit Encrypted: Zero cloud telemetry or external servers. Your financial history is stored locally in an encrypted SQLite vault (
kuber.db). - 🇮🇳 Native Indian Financial Formatting: Automatic INR currency formatting with commas at Lakhs and Crores (
₹1,42,85,000.00), mutual fund tracking, Sovereign Gold Bonds (SGBs), and real estate valuation. - 📈 Advanced Portfolio & XIRR Analytics: Real-time calculation of Extended Internal Rate of Return (XIRR) annualized growth rates across all investment assets.
- 📊 Rich Interactive Visualizations: Integrated Sankey cash flow diagrams, 12-month net worth trajectory curves, monthly bar charts, and asset allocation pie charts.
- ⚡ Ergonomic Keyboard Navigation: Sub-second Quick Add transaction modal (
Ctrl+N), instant Privacy Lock screen masking (Ctrl+L), and arrow-key tab switching. - 🔄 Integrated Auto-Updater: Built-in background release checker that polls release manifests and silently launches standalone Windows setup installers (
Kuber-Setup.exe).
Kuber/
├── main.py # Application Entry Point & Qt Application Bootstrap
├── models.py # SQLAlchemy ORM Database Schema & Relational Models
├── requirements.txt # Python Package Dependencies (PyQt6, SQLAlchemy)
├── kuber.db # Local SQLite Database Vault (Created on startup)
├── db/ # Database Initialization & Data Access Layer (queries.py)
├── ui/ # User Interface Layer (MainWindow, Theme, Dashboard, Ledger, Chart Widgets)
├── utils/ # Core Utilities (Icons, INR Formatting, SQLCipher Security, Auto-Updater)
├── installer/ # Windows Setup Scripts (Inno Setup .iss & WiX Toolset .wxs)
└── Kuber Website/ # Product Homepage, 3D Rings Animation & Distribution Portal
For a detailed file-by-file explanation, Entity-Relationship diagrams, and contributing guidelines, please refer to PROJECT_DOCUMENTATION.md.
Built with precision for financial clarity and data sovereignty.