Skip to main content
Fintheon runs as a native desktop application. The installer handles all dependencies — runtimes, build tools, the backend service, and the Electron app itself — so you do not need to install anything separately before you start. Once the installer finishes, you open the app and sign in with Google.

​
System requirements

The macOS build is the primary supported platform. Windows support is available as an experimental build and may have minor visual or performance differences.

​
Install Fintheon

Choose the method that suits you. Both paths install the same application.
Open Terminal and run:
The installer will ask you where to put the Fintheon codebase (default: ~/Documents/Codebases/fintheon). It remembers your choice so the fintheon CLI always points to the right location.

​
What the installer does

You do not need to manage any of this manually — the installer handles it end-to-end:
  • Installs Homebrew, Node.js 22, Bun, Python 3, and uv
  • Installs the Claude CLI and the Hermes agent router
  • Sets up the VProxy Anthropic OAuth gateway (opens your browser once for a one-click Anthropic login)
  • Installs all JavaScript dependencies for the frontend and backend
  • Bootstraps the environment with production-safe defaults loaded from the cloud
  • Builds the backend and frontend
  • Installs the fintheon command globally so you can manage the app from any terminal window
  • Starts the application
When the installer finishes, the Fintheon app opens automatically.
No API keys are required after installation. Sign in with Google and all AI features are available immediately.

​
Sign in

Once Fintheon opens, you will see the sign-in screen. Click Sign in with Google and authorize with your Google account. Fintheon uses Google OAuth — your Google credentials are never stored locally. After signing in, you will see the first-time tour. Step through it to get a brief orientation to each section of the workspace, or click Skip tour to go straight to the dashboard.

​
Fixing macOS Gatekeeper warnings

If macOS prevents Fintheon from opening with a message like “Fintheon can’t be opened because it is from an unidentified developer”, run the following command in Terminal:
Then try opening the app again. This clears the quarantine flag that macOS sets on downloaded applications.

​
Keeping Fintheon up to date

Run this command at any time to pull the latest version, rebuild, and restart:
The update process is zero-touch: it pulls the latest code, installs any new dependencies, backfills any new environment variables, and restarts the app. You do not need to re-run the full installer.

​
CLI reference

The fintheon command lets you manage the app from any terminal window after installation.

​
Troubleshooting

Check the backend log to see what went wrong:
Then try restarting:
Another process is holding the port. Free it and start Fintheon again:
Clear the quarantine flag:
Remove the existing installation and re-run Option A or Option B from above: