tool

Vibe-Trading

created 2026-05-04 tool · ai · agent · multi-agent · finance · trading · third-party

Vibe-Trading

Open-source multi-agent finance workspace by HKUDS. We use it as a third-party tool, not a kulify project.

What It Is

Natural-language → trading strategy / research / backtest pipeline. 74 finance skills, 29 multi-agent swarm presets, 7 backtest engines, 6 data sources with auto-fallback.

Local Setup (kulify)

  • Path: ~/Desktop/Projects/kulify/projects/Vibe-Trading/
  • Mode: Docker (docker compose up)
  • URL: http://127.0.0.1:8899 (web UI + API)
  • Provider: DeepSeek-direct, model deepseek-chat
  • Key source: Vault global key DEEPSEEK_VIBETRADE_API_KEY → DEEPSEEK_API_KEY in agent/.env via sed substitution (see Vault#Wiring vault into a project's `.env`).

Remote Deployment

Also deployed to the kulify Coolify VPS at https://vt.kulify.me (single-user, bearer auth). Full operational details — UUIDs, env vars, volume layout, threat model for shell tools = on, ops runbook — live at vibe-trading/overview.

Provider Notes

The repo’s recommended sweet-spot tier is deepseek-v3.2, grok-4.20, glm-5.1, kimi-k2.5, qwen3-max-thinking — pick from these for daily use. Avoid nano/flash-lite/coder-next variants — they break tool-calling. See vibe-trading-2026 for full reasoning.

CLI Entry Points

CommandUse
vibe-tradingInteractive TUI with slash commands
vibe-trading run -p "..."One-shot prompt (great for smoke tests)
vibe-trading serveLaunch FastAPI web UI/API
vibe-trading-mcpStart MCP server (for Claude Desktop/Code/Cursor)
vibe-trading initBootstrap .env interactively

In Docker, exec the same commands inside the container: docker exec vibe-trading-vibe-trading-1 vibe-trading run -p "...".

Architecture Quick-Reference

  • Backend: FastAPI, OpenAPI schema at /openapi.json
  • Frontend: React 19 (built into the container, served from /)
  • Persistence: Docker volumes vibe-runs (/app/agent/runs) and vibe-sessions (/app/agent/sessions)
  • Settings store: /settings/llm API echoes a saved-settings store, not the active env. The agent itself uses env vars at runtime — verify provider via docker exec ... env | grep LANGCHAIN_PROVIDER.
  • Auth: loopback-only by default. Set API_AUTH_KEY if exposing beyond 127.0.0.1.

Data Sources It Wires

  • AKShare — A-shares + HK/US/futures/forex (free, no key)
  • yfinance — HK/US equities (free, no key)
  • CCXT — 100+ crypto exchanges
  • Tushare — A-share Pro data (paid, optional — AKShare covers as fallback)
  • OKX — public crypto API
  • Futu OpenAPI — HK/A-share via local FutuOpenD daemon

Patterns Demonstrated