TL;DR

이 리포지토리는 LLM을 백엔드로 사용해 A주·港股·美股·日股·韩股 등 다중 시장의 시세·기술지표·뉴스를 수집하고, 내장된 Agent 전략으로 일일 분석 보고서와 결론(점수·매수·매도 포인트)을 자동 생성하는 오픈소스 애플리케이션이다. 모델 공급자는 Anspire·AIHubMix 등 여러 API를 지원해 백엔드를 교체하거나 다중 모델을 병행해 호출할 수 있다. 생성된 보고서는 Markdown 형태로 Web UI에 표시되며 기업微信·飞书·Telegram·Discord·Slack·이메일 등으로 자동 푸시되며, GitHub Actions를 이용해 서버 없이 정시 실행하도록 공식 지원한다. 장점은 다중 데이터 소스 통합과 즉시 배포 가능한 자동화 워크플로이며 한계는 모델·검색 품질이 API 키·뉴스 소스 구성에 크게 의존하고 투자 판단 책임은 사용자에게 있다는 점이다.

주요 기능

• 자동으로 다중 시장(A/H/US/JP/KR)의 시세·기술지표·뉴스를 수집해 분석 리포트를 생성
• LLM 백엔드(Anspire, AIHubMix 등)로 자연어 기반 결론·등급·매매 포인트를 생성
• Web 대시보드에서 수동 분석·이력 리포트·Agent 다중 질의를 수행
• GitHub Actions·Docker·로컬 스케줄로 무서버 정시 자동 실행 및 결과 푸시
• 기업微信/飞书/Telegram/Discord/Slack/이메일 등 다중 채널로 보고서를 전송

어떻게 동작하는가

시장 시세·기술지표·뉴스를 다중 소스에서 수집한 뒤 프롬프트 템플릿과 내장 Agent 전략으로 LLM을 호출해 핵심 결론·점수·매수·매도 지점을 생성한다. 생성된 Markdown 보고서는 Web UI에 표시되고 웹훅·봇 채널로 자동 전송되며 GitHub Actions나 로컬 스케줄로 주기 실행이 가능하다.

해결 문제

여러 데이터 소스를 수작업으로 통합해 결론을 도출하던 과정을 LLM 기반 파이프라인으로 자동화해 일일 분석 보고서와 다중 채널 푸시를 제공한다.

지금 주목받는 이유

레포지토리의 높은 Star(47052)·Fork 수와 Trendshift/HelloGitHub 배지, 다중 LLM 연동과 GitHub Actions 기반 자동화 워크플로로 주목을 받았다.

차별점

• 다수의 LLM 제공자(Anspire, AIHubMix, Gemini, OpenAI 호환 등)를 환경변수로 전환해 동일 파이프라인에서 백엔드를 교체할 수 있다 (LLM_CONFIG_GUIDE 문서 근거).
• GitHub Actions를 통한 '서버 없는(제로 비용) 정시 실행' 워크플로를 공식 지원해 별도 인프라 없이 자동화 가능하다.
• 금융 특화 데이터 소스(TickFlow, AkShare, Tushare, Pytdx, YFinance 등)를 통합해 시장별 지원 경계를 문서화했다.
• 15개 내장 전략을 사용하는 Agent 기반 다중 질의로 기술지표·사건·테마별 분석을 자동으로 생성한다.

사용 사례

• 매영업일 시장 마감 후 자동으로 종목별 결론·위험·매수·매도 포인트를 생성해 조직 내 의사결정 채널로 푸시할 때
• 연구자가 여러 데이터 소스와 LLM을 조합해 전략별 분석 리포트를 빠르게 프로토타입할 때
• 로컬 또는 Docker 환경에서 Web UI로 수동 조사·대화형 Agent 질의를 통해 심층 분석을 수행할 때
• 알고리즘 트레이딩 후보군을 외부 프로젝트(AlphaSift/AlphaEvo)와 연계해 후보 선별·백테스트 워크플로를 구성할 때

시작하기

로컬 설치는 git clone 후 의존성 설치, 환경 변수 파일 복사·수정, main.py 실행 순서다. 핵심 명령은: git clone https://github.com/ZhuLinsen/daily_stock_analysis.git && cd daily_stock_analysis; pip install -r requirements.txt; cp .env.example .env; python main.py.

요구사항

• Python 3.10 이상
• LLM/검색 제공자 API Key(예: ANSPIRE_API_KEYS 또는 AIHUBMIX_KEY) 중 최소 하나
• GitHub Actions 사용 시 GitHub 레포지토리 Secrets 설정 권장
• Docker 환경에서 이미지 제공(docker hub 이미지 있음), 로컬 설치 시 pip 의존성

이미지 분석