Skip to content

v0.1.0 — Initial open-source release

Latest

Choose a tag to compare

@gong1414 gong1414 released this 26 Apr 16:22
· 30 commits to main since this release

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) through arena-raider-squad
    (multi-agent attack team) to arena-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 contractcumulative_close_pct,
    stop_loss, trailing_peak_pnl_pct land in a single SQL UPDATE so
    the stop-loss monitor can never read a torn write.
  • Postgres + pgvector as the canonical store; SQLite still works for
    unit tests via aiosqlite.
  • Trade-journal RAG (T10) — every cycle's structured reasoning is
    ingested into ai.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 in ai.agno_spans and are
    served via AgentOS GET /traces.
  • G5 fault-phrase guardrail (T3) — 11 known failure phrases in the
    AI's reasoning (数据同步故障, inconsistent, system issue, …)
    auto-publish EVENT_ORCHESTRATOR_ERROR.
  • Cross-cycle session memory (T2) — Agno's session summaries +
    add_history_to_context=True carry 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 suiteuv 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 of README.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.