v0.1.0 — Initial open-source release
OmniTrade goes public. The full Agno cutover (Stages A–E) and the T1–T10
hardening passes are all green; the 4-acceptance migration spec passed
all gates. This tag marks the first version anyone outside the dev team
can clone, configure, and run.
What's in the box
- 11 named strategies competing on Gate.io / OKX perpetuals — from
arena-guardian(capital-preservation) througharena-raider-squad
(multi-agent attack team) toarena-autopilot(fully autonomous LLM). - Single-framework agent runtime — Agno 2.x is the only LLM / Agent /
MCP layer. LangGraph, LangChain, LiteLLM, mcp2py, and the WebSocket
market stream are all gone. - Atomic three-way state contract —
cumulative_close_pct,
stop_loss,trailing_peak_pnl_pctland in a single SQLUPDATEso
the stop-loss monitor can never read a torn write. - Postgres + pgvector as the canonical store; SQLite still works for
unit tests viaaiosqlite. - Trade-journal RAG (T10) — every cycle's structured reasoning is
ingested intoai.trade_journal(PgVector hybrid search); subsequent
cycles auto-inject the most semantically relevant prior decisions. - Human-in-the-loop large-open gate (T9) — opens above
HITL_OPEN_SIZE_THRESHOLD_USD(default $10 000) pause for operator
approval through the dashboard banner. - OpenTelemetry tracing (T4) — Agno + OpenInference instrument every
agent / model / tool call; spans land inai.agno_spansand are
served via AgentOSGET /traces. - G5 fault-phrase guardrail (T3) — 11 known failure phrases in the
AI's reasoning (数据同步故障,inconsistent,system issue, …)
auto-publishEVENT_ORCHESTRATOR_ERROR. - Cross-cycle session memory (T2) — Agno's session summaries +
add_history_to_context=Truecarry context across cycles. - 22 frozen-fixture characterization gate — replays at ≥ 0.95
Decision-equivalent pass rate; protects against silent agent drift. - Real-time dashboard — Next.js 14 App Router + SSE single
transport + 5-panel structured reasoning + zh/en i18n. - 702-test suite —
uv run pytest -m "not manual_qa"runs in <30s.
Open-source release prep
CONTRIBUTING.md,SECURITY.md,CODE_OF_CONDUCT.md,CHANGELOG.md.github/ISSUE_TEMPLATE/{bug_report,feature_request}.md+
pull_request_template.md⚠️ Risk disclaimer at the top ofREADME.md/README_ZH.md- 🙏 Acknowledgments section linking ~30 open-source projects this
software stands on
See CHANGELOG.md for the per-task ledger and
docs/AGNO_MIGRATION_TRACKER.md for
the full migration history.
Get started
git clone https://github.com/gong1414/omnitrade.git
cd omnitrade
cp apps/backend/.env.example .env # fill in LLM_API_KEY + GATE_API_KEY
docker compose up -d
curl -X POST http://localhost:8000/api/v1/cycle/trigger
open http://localhost:3000/dashboard⚠️ Risk reminder
OmniTrade automates real trades on cryptocurrency exchanges. Crypto
derivatives are high-leverage instruments and can cost an entire account
in a single bad cycle. Testnet (GATE_USE_TESTNET=true /
OKX_USE_TESTNET=true) is the default — keep it that way until you've
run for weeks and trust the system. The maintainers accept no liability
for losses incurred from running this software.
Thanks
To everyone whose open-source work this is built on — see
Acknowledgments
in the README for the full list. Issues and PRs welcome — the project
is actively developed.