OpenAlice

Open AliceYour one-person Wall Street. Alice is an AI trading agent that gives you your own research desk, quant team, trading floor, and risk management — all running on your laptop 24/7.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.Reasoning-driven — every trading decision is based on continuous reasoning and signal mixing. OS-native — Alice can interact with your operating system. Search the web through your browser, send messages via Telegram, and connect to local devices.FeaturesDual AI provider — switch between Claude Code CLI and Vercel AI SDK at runtime, no restart neededCrypto trading — CCXT-based execution (Bybit, OKX, Binance, etc.) with a git-like wallet (stage, commit, push)Securities trading — Alpaca integration for US equities with the same wallet workflowGuard pipeline — extensible pre-execution safety checks for both crypto and securities (max position size, max leverage, cooldown between trades)Market data — OpenBB-powered equity, crypto, commodity, and currency data layers with symbol search and technical indicator calculatorEquity research — company profiles, financial statements, ratios, analyst estimates, earnings calendar, insider trading, and market movers (top gainers, losers, most active)News collector — background RSS collection from configurable feeds with archive search tools (globNews/grepNews/readNews). Also captures OpenBB news API results via piggybackCognitive state — persistent "brain" with frontal lobe memory, emotion tracking, and commit historyEvent log — persistent append-only JSONL event log with real-time subscriptions and crash recoveryCron scheduling — event-driven cron system with AI-powered job execution and automatic delivery to the last-interacted channelEvolution mode — two-tier permission system. Normal mode sandboxes the AI to data/brain/; evolution mode gives full project access including Bash, enabling the agent to modify its own source codeHot-reload — enable/disable connectors (Telegram, MCP Ask) and reconnect trading engines at runtime without restartWeb UI — local chat interface with portfolio dashboard and full config management (trading, data sources, connectors, settings)Quick StartPrerequisites: Node.js 22+, pnpm 10+, Claude Code CLI installed and authenticated.git clone https://github.com/TraderAlice/OpenAlice.git cd OpenAlice pnpm install && pnpm build pnpm devOpen localhost:3002 and start chatting. No API keys or config needed — the default setup uses Claude Code as the AI backend with your existing login.pnpm dev # start backend (port 3002) with watch mode pnpm dev:ui # start frontend dev server (port 5173) with hot reload pnpm build # production build (backend + UI) pnpm test # run testsNote: Port 3002 serves the UI only after pnpm build. For frontend development, use pnpm dev:ui (port 5173) which proxies to the backend and provides hot reload.ConfigurationAll config lives in data/config/ as JSON files with Zod validation. Missing files fall back to sensible defaults. You can edit these files directly or use the Web UI.AI Provider — The default provider is Claude Code (claude -p subprocess). To use the Vercel AI SDK instead (Anthropic, OpenAI, Google, etc.), switch ai-provider.json to vercel-ai-sdk and add your API key to api-keys.json.Crypto Trading — Powered by CCXT. Configure exchange and API keys in crypto.json. Any CCXT-supported exchange works (Bybit, OKX, Binance, etc.).Securities Trading — Powered by Alpaca. Configure broker and API keys in securities.json. Supports paper and live trading.FilePurposeengine.jsonTrading pairs, tick interval, timeframemodel.jsonAI model provider and model nameagent.jsonMax agent steps, evolution mode toggle, Claude Code tool permissionsai-provider.jsonActive AI provider (vercel-ai-sdk or claude-code), switchable at runtimeapi-keys.jsonAI provider API keys (Anthropic, OpenAI, Google) — only needed for Vercel AI SDK modecrypto.jsonAllowed symbols, CCXT exchange config + API keys, demo trading flag, guardssecurities.jsonAllowed symbols, Alpaca broker config + API keys, paper trading flag, guardsconnectors.jsonWeb/MCP server ports, Telegram bot credentials + enable, MCP Ask enableopenbb.jsonOpenBB API URL, per-asset-class data providers, provider API keysnews-collector.jsonRSS feeds, fetch interval, retention period, OpenBB piggyback togglecompaction.jsonContext window limits, auto-compaction thresholdsheartbeat.jsonHeartbeat enable/disable, interval, active hoursPersona and heartbeat prompts use a default + user override pattern:On first run, defaults are auto-copied to the user override path. Edit the user files to customize without touching version control.