Installation

Getting started is quick. Use the simple setup below and you will be up and running in a few minutes. The manual steps are there if you prefer more control.

What you need

• A Windows computer (Windows 10 or later)
• Microsoft Excel, with macros enabled
• Python 3.10 or later
• An internet connection
• Everything else is installed for you during setup

Quick setup

1. Download the project and extract the ZIP file.
2. Move the folder to a short path, such as C:\FinForge.
3. Double-click setup.bat and wait for it to finish.
4. Double-click launch_finforge.bat to open the app.

Manual setup (optional)

If the quick setup does not work, or you prefer to do it yourself, run these commands in PowerShell from the project folder.

# Create and activate a Python environment
python -m venv .venv
.\.venv\Scripts\Activate.ps1

# Install the required packages
pip install -r requirements.txt

# Set up the Excel connection
xlwings addin install

# Install the desktop app
cd ElectronHome
npm install

Uninstall

Double-click uninstall.bat and choose what to remove. It cleans up the setup without deleting your data or source files.