FinAIOSby FinoGeeks

How to start

Developer quickstart

Run an agent inside FinShield on your own machine, then add the FinClaw runtime. Both are free to download.

  1. Install FinShield, the desktop security guard

    macOS / Linux
    curl -fsSL https://raw.githubusercontent.com/finogeeks/finsafe/main/install.sh | sh
    Windows (PowerShell)
    irm https://raw.githubusercontent.com/finogeeks/finsafe/main/install.ps1 | iex

    Then create an example policy:

    finsafe init
  2. See what your agent tries to touch

    Run your agent under FinShield with --audit to get a report of the files and network paths it tried to reach. finsafe explain and finsafe learn help you turn that into a policy.

    FinShield docs →
  3. Add FinClaw CLI, the agent runtime

    macOS / Linux
    curl -fsSL https://raw.githubusercontent.com/finogeeks/finclaw-cli/main/install.sh | sh

    The installer puts the CLI in ~/.local/bin. Add that directory to your PATH, then check with finclaw --version.

    Windows

    No one-liner. Download the x86_64 Windows archive from the FinClaw CLI releases page, extract finclaw.exe and put it on your PATH, or use WSL2 with the Linux one-liner above.

    First run:

    finclaw init
    finclaw setup
    finclaw chat
    • finclaw init — creates your local profile (starts with a mock model).
    • finclaw setup — choose your model provider and API key.
    • finclaw chat — start talking to the agent.

    FinClaw starts with a mock model. Add your model provider's key to make real model calls.

    Full install guide →
  4. Want the desktop app?

    Download FinDesk, the desktop app for your agents, from the downloads page.

    FinDesk downloads →

Next

Grow to your whole company on the same products and policies. Compare ways to start, or talk to FDE about running FinAI OS on your own servers.

FinShield and FinClaw CLI are free to download today, and we plan to open-source them.