OpenAlice is a file-driven AI trading agent engine designed for crypto and securities markets. It automates portfolio management, news fetching, quantitative analysis, and strategy execution, offering a transparent, reasoning-driven approach for users seeking 24/7 market monitoring and adjustments.

How It Works

The core architecture is file-driven, using Markdown for persona, JSON for configuration, and JSONL for conversations, enabling direct human/AI file manipulation for "vibe trading" without databases. Decisions stem from continuous reasoning and signal mixing. It boasts OS-native interaction capabilities, allowing web browsing and messaging. A key feature is its dual AI provider support, enabling runtime switching between Claude Code CLI and Vercel AI SDK, managed by a ProviderRouter. The Engine delegates tasks to AgentCenter, while ToolCenter centralizes tool registration.

Quick Start & Requirements

• Installation: Clone the repository, navigate to the directory, and run pnpm install.
• Prerequisites: Node.js 20+ and pnpm 10+ are required.
• Configuration: Set API keys (Anthropic, Exchange, Telegram, Alpaca) in a .env file and customize trading parameters via JSON files in data/config/.
• Running: Use pnpm dev for development with watch mode or pnpm build for a production build.
• Links: Live demo available at traderalice.com/live.

Highlighted Details

• AI Provider Flexibility: Seamless runtime switching between Claude Code CLI and Vercel AI SDK.
• Multi-Market Trading: Integrated CCXT for crypto (Bybit, OKX, Binance) and Alpaca for US equities, featuring a git-like wallet workflow (stage, commit, push).
• Cognitive State Management: Persistent "brain" with memory, emotion tracking, and commit history for nuanced decision-making.
• Robust Event Logging: Append-only JSONL event log with real-time subscriptions and crash recovery.
• OS Integration: Interacts with the operating system for web searches, Telegram messaging, and local device connectivity.
• Local Web UI: Built-in chat interface accessible locally on port 3002.

Maintenance & Community

No specific details regarding notable contributors, sponsorships, or community channels (e.g., Discord/Slack) were found in the provided README content.

Licensing & Compatibility

The project is released under the MIT License, which is highly permissive and generally compatible with commercial use and closed-source linking.

Limitations & Caveats

Interactive Brokers (IBKR) support for securities trading is planned but not yet implemented. The openclaw/ browser automation subsystem is marked as "frozen." Setup requires specific Node.js and pnpm versions, and external API keys are necessary for AI providers and trading platforms. The Claude Code CLI mode necessitates local installation and authentication.