LLM이 매일 아침 내 주식을 분석해준다: GitHub 트렌딩 daily_stock_analysis

오늘 GitHub Python 카테고리 트렌딩 1위. 하루 만에 별 +519개를 추가하며 누적 ★44,347에 도달한 daily_stock_analysis가 화제다. 주목받는 이유는 명확하다: LLM이 매일 아침 자동으로 내 관심 종목을 분석하고 알림을 쏴준다. 그것도 서버 비용 없이.

이게 뭔가

한 줄 요약: "AI 애널리스트가 매일 아침 내 종목 브리핑을 슬랙으로 보내주는 시스템."

사용자가 관심 종목을 설정해두면, 시스템이 A주·홍콩주·미주·일본주·한국주의 시세 데이터와 실시간 뉴스를 수집해 LLM에 분석을 위임한다. 결과물은 매수·매도 포인트, 리스크 경보, 촉매 요인, 점수가 담긴 '결정 대시보드'로 정리되어 텔레그램·슬랙·디스코드·Feishu·이메일 중 원하는 채널로 자동 전송된다. 데모는 공식 사이트에서 바로 확인 가능하다.

개발 지식 없이 설명하면: 매일 아침 알람 대신 AI가 써준 내 포트폴리오 요약본을 받는 것이다.

왜 지금 뜨는가

세 가지 조건이 2025~2026년에 동시에 충족됐다.

1. LLM API 단가 급락 — GPT-4o mini·Gemini Flash 같은 경량 모델이 실용 가격대에 안착했다. 하루 20~30종목 분석에 드는 API 비용이 월 수달러 수준이다.
2. GitHub Actions 무료 크론 — 프로젝트는 "제로 비용 정기 실행"을 명시 지원한다. 별도 서버 없이 GitHub 계정만으로 매일 자동 실행이 가능하다.
3. 개인 퀀트의 민주화 — 대형 증권사만 가능했던 멀티소스 데이터 집계 + AI 분석을 MIT 라이선스로 누구나 포크해 쓸 수 있게 됐다.

핵심 기능

기능	내용
AI 결정 리포트	핵심 결론·스코어·트렌드·매수매도 포인트·리스크 경보·촉매 요인·체크리스트
멀티마켓 지원	A주, 홍콩주, 미주, 일본주, 한국주
알림 채널	텔레그램, 슬랙, 디스코드, Feishu, 기업위챗, 이메일
실행 방식	GitHub Actions (무료), Docker, 로컬 직접 실행
웹 대시보드	브라우저 기반 워크스페이스 제공

누구에게 쓸모 있나

• 개인 투자자: 매일 아침 뉴스 서핑 대신 AI 브리핑 한 장으로 대체하고 싶은 사람
• 소규모 퀀트 팀: 멀티소스 분석 파이프라인을 빠르게 PoC하고 싶은 팀
• AI 에이전트 학습자: LLM을 실제 금융 데이터에 연결하는 파이프라인 예제로 활용
• 맞지 않는 경우: 초단타·알고리즘 자동매매를 기대한다면 잘못 찾아온 것이다. 이 툴은 의사결정 보조이지 자동 주문 시스템이 아니다.

시작하기

Python 3.10 이상이 필요하다. 기본 흐름은 세 단계다.

# 1. 레포 클론
git clone https://github.com/ZhuLinsen/daily_stock_analysis.git
cd daily_stock_analysis

# 2. 의존성 설치
pip install -r requirements.txt

# 3. 환경 변수 설정 — LLM API 키, 알림 채널 웹훅 등 입력
cp .env.example .env

GitHub Actions 무료 자동 실행을 원한다면: 레포를 Fork → 리포지토리 Secrets에 API 키 등록 → .github/workflows/ 아래 크론 스케줄 조정. 전체 가이드는 공식 문서를 참조한다.

사용 예시

예시 1 — 로컬에서 즉시 분석 실행

python main.py

설정된 종목 리스트를 읽어 LLM 분석 리포트를 생성하고, 지정한 알림 채널로 전송한다.

예시 2 — Docker로 격리 실행

docker run --env-file .env zhulinsen/daily_stock_analysis

환경 변수 파일만 넘기면 컨테이너 안에서 전체 파이프라인이 실행된다. 로컬 환경 오염 없이 테스트할 때 유용하다.

예시 3 — GitHub Actions 크론 설정 (.github/workflows/analysis.yml 일부)

on:
  schedule:
    - cron: '0 1 * * 1-5'  # UTC 01:00 = 한국시간 오전 10시 (평일)

장 시작 직후 분석이 자동으로 돌도록 크론 시간을 시장 개장 시각에 맞게 조정한다.

한계·주의

• 투자 판단은 본인 책임: AI 분석은 참고 자료다. 리포트의 "매수" 신호를 맹신하면 안 된다.
• LLM API 비용은 별도: GitHub Actions 실행 자체는 무료지만, LLM 호출 비용은 사용하는 모델과 종목 수에 따라 발생한다.
• 데이터 소스 의존성: 뉴스·시세 데이터 품질에 분석 정확도가 직결된다. 데이터 피드가 끊기면 분석 결과도 부실해진다.
• 중국 시장 중심 설계: 원래 A주(중국 본토) 분석 특화로 개발됐다. 한국·미국 주식 데이터 연동의 완성도는 직접 검증이 필요하다.

이 프로젝트는 정보 수집과 초안 분석을 자동화하는 도구다. AI가 브리핑을 써줄 수는 있지만, 최종 결정은 여전히 사람의 몫이다.