BruceLanLan/augur
Phân tích sâu repo — kết luận: watch
Kết luận: watch · Điểm bằng chứng: 83/100
Augur là hệ thống phân tích đầu tư đa tác tử (multi-agent) mô phỏng 18 huyền thoại đầu tư ảo (như Buffett, Dalio, Cathie Wood, v.v.) cùng phân tích một mã cổ phiếu. Hệ thống tổng hợp nhận định bằng cơ chế đồng thuận có trọng số, đưa ra khuyến nghị phân bổ vốn Kelly và hiển thị trên Web Dashboard phong cách Bloomberg Terminal.
✨ Tính năng nổi bật
- Mô phỏng 18 đại sư đầu tư phân tích độc lập theo 4 trường phái chính
- Cơ chế đồng thuận có trọng số (Weighted Consensus) kết hợp công thức phân bổ vốn Kelly Criterion
- Pipeline phân tích tự động 6 bước: fetch, analyze, consensus, committee, debate, sentiment
- Tích hợp dữ liệu báo cáo tài chính chính thức từ SEC EDGAR và giá thời gian thực
- Web Dashboard phong cách Bloomberg Terminal với 4 preset layout và hỗ trợ PWA
- Tích hợp giao thức MCP (Model Context Protocol) với 13 tools điều khiển workspace và phân tích
- Tính năng tranh luận đa bên (Multi-Agent Debate) và thành lập Hội đồng đầu tư tùy chỉnh
- Bộ công cụ CLI đa năng, hỗ trợ tự kiểm tra môi trường (augur doctor) và lập lịch cron job
🔥 Vì sao được chú ý
Repo nổi bật nhờ kết hợp ý tưởng độc đáo (đặt 18 huyền thoại đầu tư vào phân tích cùng một cổ phiếu) với kiến trúc Multi-Agent hiện đại và giao thức MCP. Dự án sở hữu độ hoàn thiện kỹ thuật cao với 2400+ unit tests, tích hợp dữ liệu SEC EDGAR thực tế và giao diện Bloomberg Terminal hoài cổ cực kỳ ấn tượng.
⚙️ Kiến trúc
Kiến trúc tổng quan của Augur
- Data Ingestion Layer (
fetch,MarketContext): Thu thập dữ liệu tài chính thời gian thực và báo cáo SEC EDGAR (10-K/10-Q) chính thức. - Agent Registry & Personas (
AgentRegistry,AgentResponse): Quản lý 18 tác tử thuộc 4 trường phái đầu tư (Giá trị cổ điển, Tăng trưởng, Vĩ mô, Giá trị Trung Quốc), mỗi agent có khung đánh giá và trọng số riêng. - Decision Coordination (
DecisionCoordinator): Thực thi pipeline 6 bước (fetch → analyze → consensus → committee → debate → sentiment), tính toán weighted consensus và tỷ lệ quản lý rủi ro Kelly Criterion. - Interface & Integration: Cung cấp giao diện Web Terminal phong cách Bloomberg (PWA), công cụ CLI, MCP Server (13 tools cho Claude/Hermes) và thông báo qua Bot (Telegram/Slack).
🧰 Tech stack
python · mcp · fastapi · pwa · sec-edgar · yfinance · cli
🌌 Bản đồ mã nguồn
Mỗi điểm là một symbol trong repo, gom theo thư mục. Tự quay · kéo để xoay · lăn chuột để zoom · bấm cụm để bay tới.
✅ Kết luận
watch — Augur là một dự án mẫu mực đáng theo dõi và học hỏi về mặt kiến trúc Multi-Agent, thiết kế MCP tool và UI/UX Terminal. Tuy nhiên, nếu dùng để đầu tư tài chính thực tế thì cần thận trọng thử nghiệm vì các mô hình định giá định tính từ LLM vẫn cần kiểm chứng thêm qua thời gian.
🧭 Lộ trình đọc repo
- Đọc định nghĩa Persona trong tệp cấu hình hoặc module skills/ — Tìm hiểu cách định hình tư duy và quy tắc chấm điểm của 18 đại sư đầu tư.
- Đọc AgentRegistry và AgentResponse — Hiểu cơ chế quản lý danh sách tác tử và quy chuẩn hóa cấu trúc dữ liệu phản hồi.
- Phân tích module DecisionCoordinator — Nắm bắt thuật toán tính điểm đồng thuận có trọng số và công thức phân bổ vốn Kelly.
- Đọc triển khai MCP Server (augur mcp-server) — Học cách thiết lập 13 MCP tools để kết nối hệ thống với Claude Desktop/Hermes Agent.
- Khám phá luồng pipeline augur workflow và Dashboard UI — Xem cách kết nối các thành phần từ fetch dữ liệu đến hiển thị giao diện Bloomberg Terminal.