Getting Started

Install

Get Finny running locally in under two minutes.

Recommended: curl installer

The fastest path — downloads a native binary from npm and installs it to ~/.finny/bin. No Node.js required.

bash

curl -fsSL https://finnyai.tech/cli/install | bash

Then open a new shell (or source your shell config) and run:

bash

finny

Alternative: npm / bun

Same public package the curl installer uses (finny on npm, not the private @finny-ai/finny-pro package):

bash

npm i -g finny

bash

bun install -g finny

First run

On first launch, Finny asks for your email (release notes), lets you pick a path (trader vs beginner), and starts a welcome session. Connect an AI provider via the Home prompt capsules (or /connect) if you have not already.

→

Already installed?

Re-run the curl installer any time to upgrade to the latest published version. Check with finny --version.

Backtesting prerequisites

Backtesting shells out to Python. Finny manages its own workspace venv for most runs; if you hit a missing-Python error, install Python 3 and ensure it is on PATH:

bash

brew install python   # macOS

⚠

If commands fail with “python: command not found”

Make sure Python 3 is on your PATH. On macOS, install via Homebrew: brew install python.