> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintheon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Installing Fintheon on Your Mac or Windows PC

> Two ways to install Fintheon: a one-line installer that handles everything automatically, or a manual clone-first path for users who prefer more control.

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

|                | Requirement                                               |
| -------------- | --------------------------------------------------------- |
| **macOS**      | macOS 12 Monterey or later (primary platform)             |
| **Windows**    | Windows 10 or later (experimental build)                  |
| **Disk space** | \~2 GB for dependencies and build artifacts               |
| **Internet**   | Required during install; needed at runtime for live feeds |

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

## Install Fintheon

Choose the method that suits you. Both paths install the same application.

<Tabs>
  <Tab title="One-liner (recommended)">
    Open **Terminal** and run:

    ```bash theme={null}
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/solvys-technologies/fintheon/main/scripts/fintheon-setup.sh)"
    ```

    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.
  </Tab>

  <Tab title="Clone first">
    If you prefer to inspect the code before running the installer, clone the repository manually and then run the install command from inside it:

    ```bash theme={null}
    git clone https://github.com/solvys-technologies/fintheon.git ~/Documents/Codebases/fintheon
    cd ~/Documents/Codebases/fintheon
    ./fintheon install
    ```
  </Tab>
</Tabs>

## 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.

<Note>
  No API keys are required after installation. Sign in with Google and all AI features are available immediately.
</Note>

## 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:

```bash theme={null}
xattr -cr /Applications/Fintheon.app
```

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:

```bash theme={null}
fintheon update
```

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.

| Command            | What it does                             |
| ------------------ | ---------------------------------------- |
| `fintheon install` | First-time setup                         |
| `fintheon update`  | Pull latest, rebuild, and restart        |
| `fintheon start`   | Start the backend and launch the app     |
| `fintheon stop`    | Stop everything                          |
| `fintheon restart` | Stop and start                           |
| `fintheon logs`    | Follow backend logs in real time         |
| `fintheon status`  | Check if the backend and app are running |
| `fintheon oauth`   | Reconnect your Anthropic subscription    |
| `fintheon version` | Show the current installed version       |

## Troubleshooting

<AccordionGroup>
  <Accordion title="The backend won't start">
    Check the backend log to see what went wrong:

    ```bash theme={null}
    tail -f /tmp/fintheon-backend.log
    ```

    Then try restarting:

    ```bash theme={null}
    fintheon restart
    ```
  </Accordion>

  <Accordion title="Port 8080 is already in use">
    Another process is holding the port. Free it and start Fintheon again:

    ```bash theme={null}
    lsof -ti:8080 | xargs kill -9
    fintheon start
    ```
  </Accordion>

  <Accordion title="macOS blocks the app from opening">
    Clear the quarantine flag:

    ```bash theme={null}
    xattr -cr /Applications/Fintheon.app
    ```
  </Accordion>

  <Accordion title="Something is broken and I want a clean install">
    Remove the existing installation and re-run Option A or Option B from above:

    ```bash theme={null}
    rm -rf ~/Documents/Codebases/fintheon
    ```
  </Accordion>
</AccordionGroup>