x-pai/AlphaBot

AlphaBot – 智能股票分析助手

개요 – AlphaBot은 대규모 언어 모델(LLM) 기반 채팅 어시스턴트와 시장 데이터 파이프라인, 시각화, 간단한 퀀트 거래 도우미를 함께 제공하는 오픈소스 애플리케이션입니다. 직감에만 의존하지 않고 AI 생성 분석을 원하는 개인 투자자를 대상으로 합니다.

주요 기능

AlphaBot Agent – 질문에 답하고, 최신 뉴스를 위한 웹 검색을 실행하고, 자연어 프롬프트에서 차트나 보고서를 생성할 수 있는 대화형 금융 봇입니다.
다중 소스 시장 데이터 – Alpha Vantage(글로벌 시장)와 Tushare/AKShare(중국 A주)에서 실시간 시세를 가져옵니다.
AI 강화 분석 – 기술적 분석 패턴, 기본적 지표 비교, 가격 변동을 예측하는 사전 훈련된 머신러닝 모델. LLM(OpenAI API를 통해)이 서술적 설명을 추가합니다.
거래 보조 도구 – 주식 검색, 과거 가격 보기, 일반적인 기술적 지표, 위험 평가 점수, 퀀트 전략 제안.
웹 UI – React 프론트엔드(localhost:3000에서 제공)와 Swagger 문서화된 FastAPI 백엔드(localhost:8000/api/v1/docs).

실행 방법

Docker(권장) – 리포지토리를 클론한 후 ./deploy.sh(Windows에서는 ./deploy.ps1)를 실행합니다. Docker-Compose가 백엔드, 프론트엔드, 데이터베이스 컨테이너를 빌드합니다. 서비스는 위 URL에서 접근할 수 있습니다.
수동 설치 –
- 백엔드: cd backend && pip install -r requirements.txt && uvicorn app.main:app --reload(선택적으로 python train_model.py를 실행하여 ML 예측기를 재훈련).
- 프론트엔드: cd frontend && npm install && npm run dev.
- 기본 관리자 로그인은 admin/admin123입니다.

기술 스택

백엔드 – API용 Python, FastAPI, Uvicorn, SQLAlchemy(또는 유사). LLM 호출에는 OpenAI API, 가격 예측에는 사용자 정의 ML 모델 사용.
프론트엔드 – React(JavaScript/TypeScript)로 채팅 에이전트와 차트 구성 요소를 포함한 UI.
데이터 수집 – Alpha Vantage, Tushare, AKShare API.
컨테이너화 – 원클릭 배포를 위한 Docker + Docker-Compose.

대상 독자 – 자체 호스팅하고 확장할 수 있는 기성 AI 기반 주식 분석 플랫폼을 원하는 개인 트레이더와 취미 개발자.

주의 사항 – README에는 강력한 면책 조항이 강조되어 있습니다. 이 도구는 수익을 보장하지 않으며, AI는 실수할 수 있고, 데이터 품질은 제3자 제공업체에 따라 달라집니다. 통찰력을 위해 사용하고 자동 거래 봇으로 사용하지 마십시오.

커뮤니티 및 지원 – 이 프로젝트는 WeChat 공개 계정, WeChat 그룹, QQ 그룹, Bilibili 튜토리얼 비디오를 제공합니다. WeChat QR 코드를 통한 후원이 권장됩니다.

기여 – 분기 정책, PR 템플릿, 이슈 보고 지침은 CONTRIBUTING.md를 참조하십시오.