A lightweight, personal financial application designed for local and private use. Developed rapidly with Grok 3, this app allows you to manage your finances securely on your own machine without relying on cloud services. It is ideal for users who prioritize privacy and simplicity in tracking their financial data.

• Fully local execution with no external dependencies beyond Python packages.
• Simple and minimalistic design focused on personal finance management.
• Easy setup and quick start, suitable for users familiar with Python environments.
• Runs securely within an isolated Python virtual environment.

Follow these steps to get the application up and running quickly:

# 1. Create a Python virtual environment
python3 -m venv .venv

# 2. Activate the virtual environment
source .venv/bin/activate   # Linux/macOS
# OR
.venv\Scripts\activate      # Windows

# 3. Install dependencies
pip install -r requirements.txt

# 4. Run the application
python main.py

1. Create a Python Virtual Environment
   Run the following command to create an isolated virtual environment:

   python3 -m venv .venv

2. Activate the Virtual Environment
   Activate the environment according to your operating system:

   • Linux/macOS:

     source ./.venv/bin/activate

   • Windows:

     .\.venv\Scripts\activate

3. Install Required Dependencies
   Install all dependencies listed in the requirements.txt file:

   pip install -r requirements.txt

4. Run the Application
   Launch the app by running:

   python main.py

To ensure smooth setup and operation on macOS, please consider the following:

• Use python3 explicitly in all commands as macOS may default python to Python 2.x:

  python3 -m venv .venv
  source ./.venv/bin/activate
  pip install -r requirements.txt
  python3 main.py

• If you encounter permission issues or errors installing dependencies, try installing with the --user flag:

  pip install --user -r requirements.txt

• Verify your Python version to ensure it is 3.7 or higher:

  python3 --version

• Make sure the Developer Tools are installed. If not, install them with:

  xcode-select --install

This project is for personal use and does not include a specific license.