# ALTA

> A local, research-only multi-agent system where specialized LLM agents investigate market opportunities, challenge theses, and simulate or route trades via an operator console.

ALTA (Autonomous LLM Trading Asterism) is an open-source, Apache-2.0 research project published by kyky2347 on GitHub. It runs a virtual research firm locally: four specialist Scout agents pursue leads, independent reviewers challenge the evidence, and a strategy desk compares ways to act. The README describes it as experimental research software, not investment advice or a production order management system. The latest listed release is v0.25.0, the Initial Public Research Release.

## What It Is

ALTA is a multi-agent market-research platform with an operator console, internal Shadow simulation, and a separate broker execution boundary. Its stated idea is that a thesis must survive disagreement, costs, and time before it deserves capital. Every handoff between agents leaves an inspectable record, so users can trace evidence, reviewer decisions, and outcomes by record ID.

## How the Research Workflow Runs

The four Scouts each ask a different question: change or event, market dislocation, causal or policy effects, and expectation gap. Their tools include date-aware search, issuer crawling, feeds, public datasets, and archive lookups. Two reviewers assess the thesis independently from locked views, and a moderator surfaces their disagreements. Code-based ranking then applies quality, uncertainty, and edge gates. An Expression agent compares up to three payoff plans, and an independent auditor selects one plan or Wait. Opportunities persist across research cycles, with follow-up questions, monitoring, exits, and forward-outcome records.

## Execution Modes and Limits

Shadow mode manages internal fills, costs, positions, and exits without sending broker orders. Broker API mode uses a verified, explicitly selected Paper or Live account and requires separate authorization. Connectors exist for Tiger, Alpaca, IBKR, Futu, Longbridge/Longport, and Schwab. Tiger, Alpaca, IBKR, and Futu have conditional execution paths, while Longbridge and Schwab are blocked pending identity and permission proof. The README states that live-account acceptance is not established. The initial broker lifecycle supports one active plan per account, long USD stocks and ETFs, whole shares, and DAY limit orders. Stopping ALTA does not close broker positions.

## Setup Path

ALTA runs on macOS or Linux and needs Node.js 22+, Python 3.12, uv, and Docker or OrbStack. Cloning the repository and running npm run dashboard builds the console and opens an authenticated loopback page. From there you connect credentials, assign models by role, start the managed services in Shadow mode, and inspect Scout records. The console is available in English, Simplified Chinese, and Traditional Chinese. The architecture combines a React console, a Node gateway, a Python research service, a Codex App Server harness, and PostgreSQL, with Redis for coordination.

## Features
- Four specialist Scout agents with distinct research questions
- Independent thesis assessor and challenger with locked views
- Moderator and code-based ranking with quality, uncertainty and edge gates
- Expression agent comparing up to three payoff plans with independent audit
- Shadow simulation with internal fills, costs, positions and exits
- Broker API mode with explicit account verification and separate authorization
- Operator console in English, Simplified Chinese and Traditional Chinese
- Per-role model assignment requiring different models for opposing review roles
- Durable opportunity records with evidence, hypothesis, reviews, expression and follow-up
- Point-in-time forecasts, forward outcomes and benchmark comparisons
- PostgreSQL-backed recovery and order reconciliation by persisted identity

## Integrations
Tiger, Alpaca, IBKR, Futu, Longbridge, Schwab, OpenAI Codex App Server, PostgreSQL, Redis

## Platforms
MACOS, LINUX, WEB, API, CLI

## Pricing
Open Source

## Version
v0.25.0

## Links
- Website: https://github.com/kyky2347/ALTA
- Documentation: https://github.com/kyky2347/ALTA/blob/main/docs/operations/getting-started.md
- Repository: https://github.com/kyky2347/ALTA
- EveryDev.ai: https://www.everydev.ai/tools/alta
