# Finny

> Finny is an AI trading assistant for building, validating, backtesting, and iterating on algorithmic investing strategies from your terminal. You describe a trading idea in plain English; Finny generates Python strategy code, runs backtests against real historical market data, and connects to brokerages (Alpaca, Binance) for paper and live workflows.

Finny is a CLI-based tool installed via `npm i -g finny`. It supports Bring-Your-Own-Key for major LLM providers (Anthropic Claude, OpenAI, Google Gemini, local models). Generated strategy code stays open and inspectable — no black-box trading.

## For AI agents

Each docs page has a clean markdown twin you can fetch directly:

- JSON index of all docs: https://finnyai.tech/api/docs
- Full docs as a single file: https://finnyai.tech/llms-full.txt
- Per-page markdown: append `.md` to any docs URL — e.g. `https://finnyai.tech/docs/install` → `https://finnyai.tech/docs/install.md`
- The Finny CLI itself uses these endpoints to answer "how do I…" questions about its own behavior.

## Docs

- [Intro](https://finnyai.tech/docs/intro.md): What Finny is and how it works.
- [Install](https://finnyai.tech/docs/install.md): Prerequisites (Node.js 18+, Python 3, yfinance) and first run.
- [Agent Modes](https://finnyai.tech/docs/modes.md): Build, Research, and Chat modes — press Tab to cycle.
- [Commands](https://finnyai.tech/docs/commands.md): Slash commands inside the Finny CLI (`/algos`, `/code`, `/backtest`, `/review`, `/init`, `/portfolio`, `/settings`).
- [Strategy Templates](https://finnyai.tech/docs/templates.md): Built-in starting points — momentum, mean reversion, breakout, DCA, golden cross, scalping, custom.
- [Backtesting](https://finnyai.tech/docs/backtesting.md): Run `/backtest` against historical data via yfinance. Review Sharpe Ratio, Max Drawdown, Win Rate, Profit Factor.
- [Brokerages](https://finnyai.tech/docs/brokerages.md): Connect Alpaca (US equities, USD-quoted crypto) and Binance (crypto spot testnet). Credentials stored at `~/.local/share/finny/auth.json`.
- [API Keys (BYOK)](https://finnyai.tech/docs/byok.md): Configure Claude, OpenAI, Gemini, or local LLM endpoints.
- [FAQ](https://finnyai.tech/docs/faq.md): Common questions — scope, broker support, trade execution.
- [Troubleshooting](https://finnyai.tech/docs/troubleshooting.md): Fix install errors, missing API keys, ticker data failures.

## Optional

- [Homepage](https://finnyai.tech/): Product overview, terminal demo, feature highlights.
- [Pro](https://finnyai.tech/pro): Finny Pro pricing and feature comparison.
- [Help](https://finnyai.tech/help): Support and contact.