OpenAlice

Your one-person Wall Street.

OpenAlice turns coding agents into local trading agents by giving them a workspace, files, issues, market tools, and approval-gated trading primitives.

· · · ·

[!CAUTION] OpenAlice is experimental software in active development. Many features and interfaces are incomplete and subject to breaking changes. The trading layer is especially beta. Do not use OpenAlice for live trading with real funds unless you fully understand and accept the risks involved. The authors provide no guarantees of correctness, reliability, profitability, or loss prevention.

What is OpenAlice?

OpenAlice is a local trading workspace for coding agents.

The core idea is simple: coding agents became useful quickly because software work already has a collaboration substrate. Code has git, issues, markdown docs, review workflows, linters, terminals, logs, and reproducible project folders. A coding agent can enter that world and immediately understand how to inspect, modify, review, and report work.

Trading usually does not have that shape. A trader may read news, browse charts, hold broker positions, and keep private notes, but the work is rarely organized as a collaborative system that a human and multiple AI agents can share.

OpenAlice tries to make trading agent-operable by mapping trading work onto the tools coding agents already understand:

• Workspaces - each serious task gets a directory, git repo, terminal session, and native agent CLI.
• Issues - trading work becomes self-describing markdown tasks, similar to Linear tickets.
• Tracked entities - assets, sectors, topics, theses, and people become an Obsidian-like memory graph.
• Inbox - finished work is delivered as durable reports instead of disappearing into chat history.
• Market tools - data, news, fundamentals, technical analysis, and trading account state are exposed through CLIs and local tools.
• Trading as Git - optional account actions are staged, committed, reviewed, and pushed through an approval gate.

OpenAlice does not replace Claude Code, Codex, opencode, Pi, or other coding agents. It gives them a trading-shaped place to work.

The Core Loop

Start with read-only research. You do not need a broker account to get value from OpenAlice.

1. Ask Alice for a market question, company overview, sector scan, or thesis check.
2. Track what should persist as entities and [[wikilinks]].
3. Create an issue when the work should continue, recur, or be handed to an agent later.
4. Schedule the issue by writing timing and instructions into the same markdown file.
5. Read the result in Inbox when the agent has something worth showing you.

Issue Board	Tracked Entities
Inbox	Market Tools

That loop is the main product surface today. A timer does not call a magic trading endpoint. It launches an agent against a self-describing workspace issue, using the same files, tools, memory, and reporting path an attended session uses.

What You Get

Why Local?

Trading involves private notes, account state, credentials, strategy, and real money. OpenAlice runs on your machine by default, stores state as files under ~/.openalice, and keeps broker credentials sealed at rest.

There is no Postgres or Redis to provision. Config, sessions, issues, inbox entries, workspace artifacts, news archives, and trading history are ordinary files and git repositories. That makes the system easier to inspect, back up, debug, patch, and reason about.

Quick Start

Pick the run path that matches your machine:

• macOS - use the signed Apple Silicon desktop build: macOS install.
• Windows - run from source today: Windows install.
• Linux, Intel Mac, contributors, debugging - use the source path: Source & Dev.
• Server or always-on machine - use Docker Compose: Docker deployment.

The source path is still the best early-adopter path because it gives you logs and local code:

git clone https://github.com/TraderAlice/OpenAlice.git
cd OpenAlice
pnpm install
pnpm dev

Open the UI URL printed by the terminal, usually http://localhost:5173.

You also need at least one agent CLI installed and logged in, usually claude or codex. OpenAlice runs the model loop inside that native CLI so you keep its prompt cache, terminal rendering, provider login, and tool behavior.

Documentation

The README is intentionally short. The real docs live at openalice.ai/docs.

• What is OpenAlice - the product model and current boundary.
• Quick Start - your first research, tracking, issue, schedule, and Inbox loop.
• Installation Overview - choose macOS, Windows, source, Docker, or remote access.
• Workspaces - the directory, git, CLI, and file-backed substrate.
• Workspace Automation - scheduled runs through self-describing issues.
• Workspace Webhook - trigger OpenAlice from outside systems.
• Unified Trading Account - the beta account layer and safety warnings.
• Trading as Git - staged, committed, approval-gated trading operations.
• Data & Credentials - state layout, sealed credentials, ports, and backup.

Project Status

OpenAlice is useful today for research, issue-based work, tracked memory, scheduled reports, and Inbox delivery.

Treat broker execution as beta infrastructure. Start with simulator, paper, demo, or testnet accounts. If you hit UTA errors, broker connection failures, or confusing execution behavior, bring the error to Discord or open a GitHub issue so we can reproduce it.

Getting Help

Stuck? The fastest path is usually:

1. Ask an AI coding agent to inspect the repo - OpenAlice is intentionally file-backed and agent-readable.
2. Read the docs - openalice.ai/docs.
3. Ask DeepWiki - deepwiki.com/TraderAlice/OpenAlice.
4. Join the community - Discord for English speakers, QQ group for 中文开发者.

Star History

Contributors

OpenAlice is sharper for the people who dig into it with us: the bugs they catch, the ideas they push, the UX edges they notice, the designs and reviews they bring. High-signal issues and PR proposals count here. If a report, suggestion, or implementation proposal changes the product, it gets credited.

See the full list and what each person shaped: CONTRIBUTORS.md

License

AGPL-3.0