Docs
GitHubBlog

Search Documentation

Search for a page in the docs

What is OpenAlice

OpenAlice is an autonomous AI trading agent that gives you your own research desk, quant team, trading floor, and risk management — all running on your laptop 24/7.

Core Principles

File-driven

Markdown defines persona and tasks. JSON defines config. JSONL stores conversations. Both humans and AI control Alice by reading and modifying files — the same read/write primitives that power vibe coding transfer directly to vibe trading. No database, no containers, just files.

All state lives in the data/ directory: config, sessions, trading history, brain memory, news archive, event log. You can inspect, edit, or back up everything with standard tools.

Reasoning-driven

Every trading decision is based on continuous reasoning and signal mixing. Alice doesn't execute preset rules — she reads market data, news, technicals, and fundamentals, then reasons through the decision. Every order goes through a stage-commit-push workflow with human approval at the push step, so you always have the final say.

OS-native

Alice can interact with your operating system. Search the web through your browser, send messages via Telegram, connect to local devices, and use any tool that runs on your machine. She's not sandboxed to an API — she's a first-class citizen on your desktop.

Capabilities

  • Multi-broker trading — Connect to 100+ crypto exchanges (CCXT), US equities (Alpaca), or stocks/options/futures/bonds (Interactive Brokers). Each account is a self-contained entity with its own history and risk controls.

  • Market data & research — Company profiles, financial statements, analyst estimates, earnings calendars, insider trading data, and market movers. Technical indicators with an Excel-like formula syntax. No external sidecar needed — data engine runs in-process.

  • News monitoring — Background RSS collection from configurable feeds with archive search tools. Alice can scan headlines, read full articles, and incorporate news into her reasoning.

  • Cognitive state — A persistent "brain" with working memory that carries across conversations, emotion tracking with state transitions, and full commit history. Customizable persona via Markdown.

  • Automation — Cron scheduling for periodic tasks, heartbeat check-ins for market monitoring, and event-driven notifications delivered to whichever channel you last used.

  • Multi-provider AI — Switch between Claude (via Agent SDK with OAuth or API key) and Vercel AI SDK (Anthropic, OpenAI, Google) at runtime. No restart needed.

  • Web UI & Telegram — Local chat interface with real-time streaming, portfolio dashboard, equity curve visualization, and full config management. Telegram bot for mobile access.

Architecture at a Glance

OpenAlice is organized in four layers:

  • Providers — Interchangeable AI backends (Claude Agent SDK or Vercel AI SDK). A router reads config on each call and selects the active provider at runtime.

  • Core — AgentCenter orchestrates all AI calls. ToolCenter is a centralized registry where domain capabilities are registered once and exported to any consumer. ConnectorCenter routes messages to whichever channel you last interacted through. EventLog provides persistent event storage with real-time subscriptions.

  • Domain — Business logic modules: trading (unified accounts, git-like history, guard pipeline, snapshots), market data, analysis, news, and brain. Each module owns its state and persistence.

  • Interfaces — Web UI for local chat, Telegram bot for mobile, MCP server for tool exposure. External agents can also converse with Alice via a separate MCP endpoint.

OpenAlice is experimental software in active development. Many features and interfaces are incomplete and subject to breaking changes. Do not use this software for live trading with real funds unless you fully understand and accept the risks involved.

Next Steps