OpenAlice README

The project's README from github.com/TraderAlice/OpenAlice. As one markdown file: README.md.

OpenAlice

OpenAlice

The AI orchestrator for trading.
Your one-person Wall Street — bring your AI agents, market tools, research, and trading accounts into one local workspace.

Website · Docs · X (Twitter) · Discord · QQ

Install OpenAlice · Features · Quick Start

Ask Alice: choose a Workspace and agent, then start a market research task

Research a company, test an idea, keep a thesis under review, or prepare a trade. OpenAlice connects the agents you already use to market data, dedicated research workspaces, scheduled tasks, and trading accounts. Work with one agent or several; your files, research history, and follow-ups stay in place between sessions.

Get Started

Download the desktop app for macOS or Windows. The desktop app includes Pi; connect a model credential or supported login to start researching. You do not need a broker account.

Prefer a terminal or server? See the CLI installer, remote quickstart, or Docker setup. For platform details, see the installation guide.

Try a first task in Ask Alice:

Build a thesis on NVDA. Compare fundamentals with sector trends and price behavior, save the research in this Workspace, and explain what would prove the thesis wrong.

Continue with a follow-up, turn it into a recurring Issue, or take the idea into AutoQuant for quantitative research. Walk through your first research workflow →

Features

Put your agents to work with market tools

Use Claude Code, Codex, OpenCode, Pi, Oh My Pi, and other supported native agents with Alice's market data, fundamentals, news, and quantitative tools. Inspect the same markets yourself in the UI, then ask an agent to investigate further. Available data depends on your configured providers.

Give each line of research a place to grow

Keep conversations, files, and Git history together in reusable Workspaces. Use Chat for general research, AutoQuant for quantitative projects and experiments, and Auto Prediction for prediction-market research. The specialist workspaces have their own Studio interfaces and can be developed by the agent working inside them.

Keep following the ideas that matter

Link research to assets and topics in Tracked. Turn follow-up work into Issues with instructions and a schedule: a morning scan, a weekly macro review, or a recurring check on a thesis. Scheduled runs use the Workspace's agent and context.

Get results you can follow up on

Inbox brings together reports, questions, and updates from your Workspaces. Open the research file or reply to the Session that produced it. Use Workspace Manager to inspect who owns what, review scheduled work, and coordinate across Workspaces when you need a wider view.

Issues with scheduled research, run status, and work awaiting human review Tracked graph connecting assets, research topics, notes, and Issues
Keep research moving
Issues, schedules, and work that needs attention.
Connect your research
Assets, topics, and the work behind your ideas.
Inbox report with a research attachment and a reply to the originating Session Market view with price history, company profile, and fundamental metrics
Read, then follow up
Reports and a direct path back to their author.
Explore the market
Prices, fundamentals, and context for your next question.

Bring research to a trading decision

Connect supported brokers through Unified Trading Account to inspect holdings, orders, and account state. With AI trading enabled, agents can stage proposed operations and commit their rationale. You review and approve execution through Trading as Git.

[!CAUTION] Trading execution is beta. Start with simulator, paper, demo, or testnet accounts. OpenAlice is experimental software; interfaces may change, and it provides no guarantees of correctness, reliability, profitability, or loss prevention. Use real funds only if you understand and accept the risks.

Unified Trading Account · Trading as Git

Local and Yours

OpenAlice runs on your machine by default. Workspaces are directories and Git repositories you can inspect, edit, and back up. Alice stores its own state under ~/.openalice and seals broker credentials at rest. Your chosen agents and data providers still use their configured services.

Native agents keep their own model loops and tool behavior. Workspace files, skills, and dedicated research projects give them the context to do trading work.

Data, credentials, and backups →

Documentation and Help

Development

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

Open the UI URL printed by the terminal. Source installs need at least one host agent CLI and its model credentials or login. See Source & Dev for setup and CONTRIBUTING.md before opening a PR.

Star History

OpenAlice GitHub star history

Current GitHub stars

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.

@bakabird @2233admin @lvysssss @walkonbothsides @bakabaka0613 @JasonWang1124 @rudyll @jalilsedna @dbydd @enderzcx @eutialia

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

License

AGPL-3.0

OpenAlice (TraderAlice/OpenAlice)

trading-bot
Searching Database…

What is this?An AI trading orchestrator for a one-person desk: it connects coding agents you already use to market data, research workspaces, scheduled tasks, and trading accounts, covering the path from research and thesis-building through position entry, management, and exit.
Is this a desktop app, a server, or a CLI tool?All three: a desktop app for macOS and Windows that ships with the Pi agent, plus a CLI installer, remote quickstart, and Docker setup if you prefer a terminal or a server.
How do I get it running?Download the desktop app, connect a model credential or supported login, and try a first task in Ask Alice — you do not need a broker account to start researching.
Which AI agents can I plug into it?Native agents you already have: Claude Code, Codex, OpenCode, Pi, Oh My Pi, and others, each with its own model credentials or login. Available market data depends on the providers you configure.
Can I let it trade real money today?Trading execution is in beta: start with simulator, paper, demo, or testnet accounts. OpenAlice is experimental software with no guarantees of correctness, reliability, or profitability — use real funds only if you accept the risks.
Where does my data and account access live?It runs locally by default: workspaces are Git repositories you can inspect and back up, state lives under ~/.openalice, and broker credentials are sealed at rest — though your chosen agents and data providers still call their own configured services.
Is there anything unusual about its license?AGPL-3.0, a strong copyleft license: modified versions you distribute or run as a network service must be released under the same terms.
What would my first task in it look like?Ask Alice to build a thesis on NVDA: compare fundamentals with sector trends and price behavior, save the research in the workspace, and spell out what would prove the thesis wrong. You can then continue the thread, turn it into a recurring Issue, or take it into AutoQuant.
What are Chat, AutoQuant, and Auto Prediction?Reusable Workspaces for different kinds of work: Chat for general research, AutoQuant for quantitative projects and experiments, Auto Prediction for prediction-market research. Each keeps conversations, files, and Git history between sessions and has its own Studio interface.
How does an agent actually place a trade?Brokers connect through the Unified Trading Account, where you can inspect holdings, orders, and account state. With AI trading enabled, agents stage proposed operations and commit their rationale, and you review and approve execution through Trading as Git.
How does it keep long-running ideas on track?Tracked links research to assets and topics, and follow-ups become scheduled Issues — a morning scan, a weekly macro review, a recurring thesis check — run with the workspace's agent and context. Results land in the Inbox with a path back to the session that produced them.
Size
68.7 MB
Stars
7.3K
Age
7mo
Commits · 90 Days