OpenAlice with OpenBB API Integration

OpenAlice is an AI trading agent that automates research, execution, and risk management, running on your Ubuntu server and integrating seamlessly with your existing OpenBB API.

| 2 min read
OpenAlice is an AI trading agent that automates research, execution, and risk management, running on your Ubuntu server and integrating seamlessly with your existing OpenBB API.

TL;DR
OpenAlice is an AI trading agent that automates research, execution, and risk management across equities, crypto, forex, and macro assets. It runs on your Ubuntu server, integrates with your existing OpenBB API, and can be fully installed in under 10 minutes with pnpm install && pnpm build.

Good For
Your Ubuntu server with OpenBB API already deployed. This solves the pain point of manually connecting a high‑frequency agent to that data source – OpenAlice natively supports OpenBB API as a backend, so you get a ready‑to‑trade agent without rewriting data‑fetching logic.

The Approach 

# 1. Clone the repository
git clone https://github.com/TraderAlice/OpenAlice.git
cd OpenAlice

# 2. Install dependencies (Node.js 22+ and pnpm 10+ required)
pnpm install

# 3. Build the project
pnpm build

# 4. Configure OpenAlice to use your external OpenBB API
# Edit data/config/market-data.json (created on first run) and set:
cat > data/config/market-data.json <<EOF
{
  "enabled": true,
  "backend": "openbb-api",
  "apiServer": {
    "enabled": false,
    "port": 6901
  },
  "providers": {
    "equity": "yfinance",
    "crypto": "yfinance",
    "currency": "yfinance"
  },
  "providerKeys": {}
}
EOF

# 5. Start the development server
pnpm dev

OpenAlice will now route all data requests through your pre‑existing OpenBB API.

Why It Worked

  • The market-data.json file lets you switch the data backend from the built‑in OpenTypeBB SDK to an external OpenBB API with one field change.
  • No extra Python or Docker sidecar is needed – OpenAlice is pure TypeScript/Node.js, so integration stays lightweight and fast.
  • The embedded HTTP server (if enabled) runs on port 6901, providing full OpenBB‑compatible REST endpoints for real‑time quotes, historical data, and macroeconomic indicators.

How to Use

  • Prerequisites: Node.js 22+, pnpm 10+, and Claude Code CLI (optional, for AI features).
  • Command cheat sheet
# Clone & build
git clone https://github.com/TraderAlice/OpenAlice.git
cd OpenAlice
pnpm install && pnpm build

# Run (port 3002 by default)
pnpm dev

# Test OpenAlice is using your API
curl http://localhost:3002/api/v1/health
  • Troubleshooting: If OpenAlice falls back to the local OpenTypeBB SDK, ensure backend is exactly "openbb-api" in data/config/market-data.json and that your OpenBB API server is reachable from the Ubuntu server.

Source