BruceLanLan/augur

Kết luận: fit · Công nghệ: python · multi-agent · llm · stock-analysis · financial-analysis

Augur là hệ thống phân tích đầu tư đa agent mô phỏng triết lý của 13 nhà đầu tư huyền thoại cho cùng một mã cổ phiếu. Hệ thống tổng hợp nhận định qua cơ chế đồng thuận có trọng số, đưa ra điểm số Augur (0–10), tín hiệu giao dịch và đề xuất phân bổ vốn theo Kelly Criterion. Ứng dụng đi kèm giao diện Web dashboard phong cách Bloomberg hỗ trợ so sánh luận điểm đa chiều.

📖 Giới thiệu chi tiết

🧩 Nó là gì?

BruceLanLan/augur là một công cụ AI hỗ trợ phân tích đầu tư chứng khoán, đóng vai trò như một "hội đồng đầu tư ảo" tụ họp 18 nhà đầu tư huyền thoại (như Warren Buffett, Ray Dalio, Cathie Wood, Đoạn Vĩnh Bình...) để cùng soi xét một mã cổ phiếu và đưa ra kết luận chung.

🎯 Giải quyết vấn đề gì? Dành cho ai?

• Giải quyết vấn đề gì?: Khi phân tích một cổ phiếu, mỗi người thường bị giới hạn bởi một góc nhìn duy nhất (người thích cổ phiếu giá trị, người lại chuộng cổ phiếu tăng trưởng). Augur giải quyết điều này bằng cách tổng hợp góc nhìn của 18 trường phái đầu tư khác nhau, tự động đưa ra thang điểm đồng thuận (Augur score từ 0–10), tín hiệu giao dịch (BUY / NEUTRAL / SELL) và gợi ý tỷ trọng đi vốn an toàn (tỷ lệ Kelly).
• Dành cho ai?:
  • Nhà đầu tư cá nhân: Muốn có cái nhìn đa chiều, chuyên sâu về một mã cổ phiếu (Mỹ, Trung Quốc, Hồng Kông) mà không mất hàng tuần đọc báo cáo tài chính phức tạp.
  • Trader & Phân tích viên: Muốn một giao diện làm việc chuyên nghiệp chuẩn phong cách Bloomberg Terminal hoặc tích hợp trợ lý AI vào quy trình làm việc hàng ngày.

⚙️ Hoạt động ra sao?

• Thu thập dữ liệu thực tế: Tự động tải báo cáo tài chính chính thức từ SEC EDGAR (10-K, 10-Q), theo dõi giao dịch của ban lãnh đạo (nội bộ) và biến động của các quỹ đầu tư lớn.
• 18 "nhà đầu tư AI" phân tích độc lập: Mỗi vị đại sư đại diện cho một phương pháp (Giá trị kinh điển, Tăng trưởng đổi mới, Chu kỳ vĩ mô, Giá trị Trung Quốc) và chấm điểm theo tiêu chí riêng (PE, ROE, lợi thế cạnh tranh, biên an toàn...).
• Tổng hợp đồng thuận & Gợi ý đi vốn: Kết hợp điểm số của cả hội đồng để đưa ra nhận định chung (The Oracle of Augur) kèm tỷ trọng phân bổ vốn khuyên dùng (Kelly position).
• Tranh luận đa chiều & Phản biện: Cho phép chọn 2–4 nhà đầu tư AI đối đầu trực tiếp để tìm ra điểm mạnh (Bullish) và rủi ro (Bearish) của doanh nghiệp.
• Kết nối linh hoạt: Sử dụng được qua giao diện Web Dashboard, dòng lệnh CLI, hoặc kết nối trực tiếp vào các AI Agent như Claude Desktop hay Hermes Agent thông qua giao thức MCP (Model Context Protocol).

🆚 Khi nào nên dùng / không nên

• Nên dùng khi:
  • Bạn chuẩn bị mua một mã cổ phiếu và muốn kiểm tra xem các góc nhìn đầu tư khác nhau đánh giá nó ra sao.
  • Bạn muốn tự động hóa quy trình theo dõi danh mục và chạy báo cáo phân tích định kỳ.
  • Bạn thích làm việc trên một giao diện chuyên nghiệp kiểu Bloomberg Terminal có thể tùy biến cao.
• Không nên dùng khi:
  • Bạn chỉ muốn đánh sóng siêu ngắn hạn (scalping, giao dịch theo giây/phút) mà không quan tâm đến yếu tố cơ bản của doanh nghiệp.
  • Bạn tìm kiếm một "quả cầu tuyết" dự đoán chính xác 100% biến động giá (Augur là công cụ hỗ trợ phân tích và đưa ra góc nhìn tham khảo, không phải lời hứa đảm bảo lợi nhuận).

🚀 Bắt đầu nhanh

Bước 1: Cài đặt dự án qua terminal

git clone https://github.com/BruceLanLan/augur.git && cd augur
pip install -e ".[data]"

Bước 2: Khởi động giao diện Web Dashboard

augur serve --open          # Mở Dashboard ngay trên trình duyệt

Bước 3: Hoặc chạy phân tích trực tiếp từ dòng lệnh CLI

augur analyze AAPL          # 18 nhà đầu tư cùng phân tích mã AAPL
augur consensus NVDA        # Điểm đồng thuận + gợi ý tỷ trọng Kelly cho NVDA
augur workflow TSLA         # Tự động chạy trọn gói quy trình phân tích cho TSLA

✅ Điểm mạnh & ⚠️ Hạn chế

✅ Điểm mạnh:

• Góc nhìn đa chiều: Tổng hợp 18 trường phái đầu tư lớn giúp hạn chế tối đa thiên vị cá nhân.
• Dữ liệu tài chính minh bạch: Kết nối trực tiếp dữ liệu báo cáo tài chính chính thức SEC EDGAR và dữ liệu thị trường thực tế.
• Tích hợp phong phú: Hỗ trợ Web Dashboard, dòng lệnh CLI, PWA, Bot (Telegram, Slack) và 13 công cụ MCP kết nối mượt mà với AI Agent.
• Khả năng tùy biến cao: Cho phép tự tạo nhà đầu tư AI mới theo công thức cá nhân và lưu nhiều Profile cấu hình làm việc.

⚠️ Hạn chế:

• Cần biết sử dụng dòng lệnh cơ bản: Cài đặt bản tự vận hành (self-host) yêu cầu có môi trường Python và thao tác terminal đơn giản.
• Phụ thuộc vào kết nối dữ liệu: Một số nguồn dữ liệu bên thứ ba có thể bị giới hạn truy cập (rate-limit) tùy thuộc vào mạng của bạn (tuy nhiên project có sẵn lệnh augur doctor để kiểm tra mạng).