AI 기반 한국 주식 투자 플랫폼 - GitHub Organization
Stockelper는 LLM 기반 다중 에이전트 시스템, Neo4j 지식 그래프, Black-Litterman 포트폴리오 최적화를 활용하여 투자자에게 맞춤형 투자 전략을 제공하는 종합 AI 투자 플랫폼입니다.
한국 주식 시장에 특화된 마이크로서비스들이 유기적으로 연동되어, 실시간 AI 상담부터 포트폴리오 추천, 백테스팅까지 전 과정을 지원합니다.
┌─────────────────────────────────────────────────────────────────┐
│ 사용자 │
└───────────────────────────┬─────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ stockelper-fe (Next.js 15) │
│ Port: 3000 / 80 │
│ - 회원가입/로그인 - AI 채팅 인터페이스 │
│ - 투자 성향 설문조사 - 백테스팅 요청 및 결과 │
│ - 포트폴리오 추천 조회 - KIS API 설정 관리 │
└────────┬────────────────────┬────────────────────┬───────────────┘
│ │ │
▼ ▼ ▼
┌────────────────┐ ┌───────────────┐ ┌────────────────┐
│ stockelper-llm │ │ stockelper- │ │ stockelper- │
│ (LangGraph) │◄──►│ portfolio │ │ backtesting │
│ Port: 21009 │ │ Port: 21008 │ │ Port: 21007 │
│ │ │ │ │ │
│ 멀티 에이전트 │ │ Black-Litterman│ │ OpenAI Agents │
│ SSE 스트리밍 │ │ 자동매매 │ │ Worker 시스템 │
└────────┬───────┘ └───────┬───────┘ └────────┬───────┘
│ │ │
│ ┌───────┴────────┐ │
│ │ │ │
▼ ▼ ▼ ▼
┌─────────────────────────────────────────────────────────────────┐
│ stockelper-airflow (데이터 파이프라인) │
│ Port: 21003 │
│ - 일일 주가 수집 (KRX) - DART 공시 수집 │
│ - 금융 리포트 크롤링 - 경쟁사 정보 수집 │
│ - Neo4j 지식 그래프 구축 - 뉴스 크롤링 │
└────────┬────────────────────┬────────────────────┬───────────────┘
│ │ │
▼ ▼ ▼
┌────────────────┐ ┌───────────────┐ ┌────────────────┐
│ PostgreSQL │ │ MongoDB │ │ Neo4j │
│ Port: 5432 │ │ Port: 27017 │ │ Port: 7687 │
│ │ │ │ │ │
│ - 사용자 데이터 │ │ - 뉴스/리포트 │ │ - 지식 그래프 │
│ - 백테스트 결과 │ │ - 경쟁사 정보 │ │ - 기업 관계 │
└────────────────┘ └───────────────┘ └────────────────┘
| 레포지토리 | 설명 | 기술 스택 | 포트 |
|---|---|---|---|
| stockelper-fe | 프론트엔드 애플리케이션 | Next.js 15, React 19, TypeScript, Prisma | 3000 |
| stockelper-llm | LLM 채팅/분석 서비스 | FastAPI, LangGraph, LangChain, Neo4j | 21009 |
| stockelper-portfolio | 포트폴리오 추천/매매 | FastAPI, OpenAI Agents SDK, Black-Litterman | 21008 |
| stockelper-backtesting | 백테스팅 서비스 | FastAPI, OpenAI Agents SDK, Backtrader | 21007 |
| stockelper-airflow | 데이터 파이프라인 | Apache Airflow, Selenium, FinanceDataReader | 21003 |
| stockelper-kg | 지식 그래프 빌더 | Python, Neo4j, GPT-4 | CLI |
| stockelper-news-crawler | 뉴스 크롤러 | Python, BeautifulSoup, MongoDB | CLI |
| stockelper-workspace | 워크스페이스/문서 | Documentation | - |
- LangGraph 기반 멀티 에이전트 시스템 (시장 분석, 기본적 분석, 기술적 분석, 투자 전략, GraphRAG)
- SSE 스트리밍을 통한 실시간 응답
- Neo4j 지식 그래프 기반 근거 제공
- 투자 성향 설문조사 (8가지 질문)
- Black-Litterman 모델 기반 포트폴리오 최적화
- 시가총액 기반 종목 랭킹 시스템
- KIS API 자동매매 실행
- OpenAI Agents SDK 기반 전략 시뮬레이션
- 비동기 워커 시스템
- LLM 기반 결과 해석 및 리포트 생성
- Apache Airflow 기반 자동화된 데이터 수집
- KRX 일일 주가, DART 공시, 금융 리포트 크롤링
- Neo4j 지식 그래프 자동 구축
- Neo4j 기반 기업 관계 데이터베이스
- 스트리밍 모드 (중단 후 자동 재개)
- GPT-4 기반 뉴스 이벤트 분류
- Next.js 15, React 19, TypeScript
- Tailwind CSS, Radix UI
- Prisma ORM, TanStack React Query
- FastAPI, Python 3.12
- LangGraph, LangChain, OpenAI Agents SDK
- Backtrader, Prophet
- PostgreSQL (사용자 데이터, 체크포인트)
- MongoDB (뉴스, 리포트)
- Neo4j (지식 그래프)
- Apache Airflow
- Selenium, FinanceDataReader, OpenDartReader
- OpenAI API (GPT-4)
- KIS OpenAPI (한국투자증권)
- DART (금융감독원)
각 서비스의 설치 및 실행 방법은 해당 레포지토리의 README를 참조하세요.
- Docker & Docker Compose
- Python 3.12+
- Node.js 20+ & pnpm 9+
- uv (Python 패키지 관리자)
모든 서비스는 stockelper Docker 네트워크를 공유합니다:
docker network create stockelperMIT License - Copyright (c) 2025 Stockelper-Lab
Stockelper-Lab Team
AI 기술과 금융 데이터를 결합하여 투자자에게 더 나은 의사결정 도구를 제공합니다.
- GitHub Organization: https://github.com/Stockelper-Lab
- Issues: 각 레포지토리의 GitHub Issues
- 대표 이메일: videorighter@gmail.com
Stockelper-Lab Team