Installation - 0 Finance Docs

Install with curl

curl -fsSL https://zerofinance.ai/install | bash

This installs Bun if needed, then installs agent-bank globally.

Install with Bun

bun add -g agent-bank

Verify the installation:

zero --version

The CLI binary is zero (alias: zero-bank).

Run from the repo

The CLI lives in packages/cli and can be run directly from source:

bun install
bun --cwd packages/cli run dev -- auth connect --no-browser

Use zero --debug auth whoami to print the resolved base URL.

Authenticate

Step 1: Get your API key

Log in to 0.finance
Go to Settings → API Keys
Click Create API Key
Copy the key (it starts with sk_live_ or sk_test_)

Store your API key securely. It provides full access to your workspace.

Step 2: Connect the CLI

Option A: Browser connect (recommended)

zero auth connect

This opens a secure connection page on www.0.finance and stores the API key for you. If the automatic handoff fails, the page shows a copyable key for manual paste. Option B: API key

zero auth login --api-key sk_live_your_api_key_here

This stores your credentials in ~/.zero-finance/config.json.

Step 3: Verify

zero auth whoami

{
  "workspace_id": "ws_xxx",
  "workspace_name": "My Company",
  "key_id": "key_xxx",
  "key_name": "Production Key",
  "align_customer_id": "align_xxx"
}

Configuration

The CLI stores configuration in ~/.zero-finance/config.json:

{
  "apiKey": "sk_live_xxx",
  "baseUrl": "https://www.0.finance"
}

Custom base URL

For self-hosted deployments or local development:

zero auth login --api-key sk_test_xxx --base-url http://localhost:3050

The base URL should be the root (e.g. https://www.0.finance), not .../api/cli. The CLI will normalize if you include /api/cli.

Log out

Remove stored credentials:

zero auth logout

Next steps

CLI Reference

Complete command reference with examples.

Check balance

Your first CLI command.

CLI QA

Functionality coverage and smoke-test results.

​Install with curl

​Install with Bun

​Run from the repo

​Authenticate

​Step 1: Get your API key

​Step 2: Connect the CLI

​Step 3: Verify

​Configuration

​Custom base URL

​Log out

​Next steps

CLI Reference

Check balance

CLI QA

Install with curl

Install with Bun

Run from the repo

Authenticate

Step 1: Get your API key

Step 2: Connect the CLI

Step 3: Verify

Configuration

Custom base URL

Log out

Next steps