Installation

Quick Install (recommended)

curl -fsSL https://raw.githubusercontent.com/minara-ai/minara-agent/main/scripts/install.sh | bash

Works on Linux, macOS, WSL2, and Android via Termux. The installer detects your OS and distro, checks Node ≥ 24 and the native build toolchain (Xcode CLT / build-essential / clang on Termux), clones the repo into ~/.minara/minara-agent, runs npm install, drops a minara shim into ~/.local/bin, and launches the setup wizard.

Windows: Native Windows is not supported. Install WSL2 and run the command above from inside your WSL shell.

After installation:

source ~/.bashrc          # reload shell (or: source ~/.zshrc)
minara setup              # first-run wizard — provider + Minara login + workspace
minara serve --ui         # serve gateway + Web UI together (prints a URL to open)
minara                    # or chat right in the terminal

Installer flags

curl -fsSL https://raw.githubusercontent.com/minara-ai/minara-agent/main/scripts/install.sh \
  | bash -s -- --dir ~/code/minara --branch main --skip-setup

Manual install

If you prefer to manage the clone yourself, or the quick installer doesn't cover your environment:

Requirements

• Node.js ≥ 24 (strict; we rely on process.loadEnvFile, stable since Node 22.5)
• A C/C++ toolchain for better-sqlite3:
  • macOS: Xcode Command Line Tools (xcode-select --install)
  • Debian/Ubuntu: build-essential
  • Termux: clang
• A Minara account (one credential covers stocks, commodities, FX, perps, and digital assets)
• At least one LLM provider (Anthropic Pro/Max via Claude CLI, Anthropic API, ChatGPT Plus/Pro, or OpenRouter)

Clone and install

git clone https://github.com/minara-ai/minara-agent.git
cd minara-agent
npm install

Authenticate

Minara needs a Minara account (for trading and market data) and an LLM provider (for reasoning). Both live in ~/.minara/auth-profiles.json.

# 1. Minara account (device flow)
minara login minara

# 2. LLM provider — pick any one
minara login anthropic     # Anthropic Pro/Max — reuse existing Claude CLI credentials
minara login openai        # ChatGPT Plus/Pro via browser OAuth
minara login openrouter    # OpenRouter via browser PKCE

Or pass keys through env vars (see Environment Variables):

export MINARA_API_KEY="mnr_..."
export ANTHROPIC_API_KEY="sk-ant-..."      # or OPENROUTER_API_KEY

If you start the CLI with no provider configured, a setup wizard walks you through one of the login flows.

Update

Pull the latest and reinstall:

cd ~/.minara/minara-agent    # or wherever you cloned
git pull
npm install

Or re-run the quick installer (it detects the existing clone and updates in place):

curl -fsSL https://raw.githubusercontent.com/minara-ai/minara-agent/main/scripts/install.sh | bash

Uninstall

rm -rf ~/.minara/minara-agent    # remove the repo
rm -f ~/.local/bin/minara        # remove the shim

Your data directory (~/.minara/) contains SQLite state, auth profiles, and logs. Delete it too if you want a clean slate:

rm -rf ~/.minara                 # removes ALL data

Docker

docker build -t minara .
docker run --rm -it \
  -v minara-data:/data \
  -e ANTHROPIC_API_KEY=sk-... \
  -e MINARA_API_KEY=mnr_... \
  minara

See Deployment for the full Docker guide (HTTP gateway mode, autopilot-only deploy, health checks, horizontal scaling).

Verify

minara doctor              # health check — LLM, Minara auth, tools, workspace
minara doctor --probe-llm  # also ping the LLM to verify connectivity

All checks green means you're ready. See Your First Trade for the hands-on walkthrough.