agentpit-io/hunter-community

HunterCode란 무엇인가?

HunterCode는 주식 시장 조사를 위한 자체 호스팅 AI 어시스턴트입니다. 자신의 컴퓨터나 서버에서 실행하고, 대규모 언어 모델(LLM)용 API 키를 제공하면, 실시간 시장 데이터를 가져오고, 뉴스를 가져오고, 개별 주식을 분석하고, 가격 추세를 예측하고, 관심 목록과 보유 종목을 관리할 수 있습니다. 모든 대화와 데이터는 자신의 머신에 있는 로컬 데이터베이스에 저장됩니다. 제3자 서비스로 전송되지 않습니다.

이는 데이터를 통제하고 자체 데이터 소스나 분석 방법을 연결하려는 개인 투자자, 사모펀드 연구원, 소규모 퀀트 팀을 대상으로 합니다.

실제로 무엇을 하나요?

거래 봇이 아닌 조사 어시스턴트로 생각하세요. 브로커에 연결하지 않고, 거래를 하지 않으며, 예측을 보장하지 않습니다. 대신 공개 데이터, 분석 방법론, LLM을 일관된 조사 워크플로우로 구성합니다.

주요 기능:

• 시장 데이터: 실시간 시세, 캔들스틱 차트, 재무 보고서, 뉴스, 주요 주주, A주(중국), 홍콩, 미국 주식의 북향/남향 자금 흐름.
• AI 분석: 다차원 조사 보고서(기본적 분석, 기술적 분석, 자금 흐름)를 생성하는 "딥 분석" 에이전트, 9가지 다른 투자 학파가 주식에 투표하는 "투자자 패널", 시장 전체 주식 스크리너, 가격 예측 모듈(Kronos, 칭화대 시계열 모델 기반).
• 대화: 시세, 뉴스, 예측을 보여주는 리치 카드로 채팅.
• SKILL 시스템: 분석 방법론을 Markdown 파일(Anthropic Agent Skills 표준 형식 사용)로 작성하고 GitHub에서 원클릭으로 스킬을 설치할 수 있습니다. 펌프 앤 덤프 신호를 스캔하는 사기 탐지 스킬을 포함하여 6가지 스킬이 내장되어 있습니다.
• 페이퍼 트레이딩: 전체 주문 수명 주기(시세 스냅샷 → 위험 검사 → 체결 → 회계 → 보고서)를 실행하는 모의 거래 원장으로, 실제 돈에는 접촉하지 않습니다. 의도적으로 격리되어 있습니다. 코드는 실제 거래 매개변수를 거부하고, 데이터베이스 역할은 문자 그대로 원장 항목을 수정하거나 삭제할 권한이 없습니다.
• 확장성: 자체 MCP(Model Context Protocol) 도구, OpenAI 호환 LLM 게이트웨이, 또는 자체 데이터 소스를 연결할 수 있습니다.

내부적으로 어떻게 작동하나요?

HunterCode는 다중 서비스 Docker Compose 애플리케이션입니다:

• 웹 프론트엔드(Next.js 15) — 브라우저 인터페이스
• API 백엔드(FastAPI) — 인증, 데이터 액세스, 모델 호출, 스킬 로드
• 대화 엔진(맞춤형 OpenCode) — LLM 도구 호출 루프 처리
• Postgres + Redis — 저장 및 캐싱
• llm-shim — 도구 스키마를 정리하고 일부 추론 모델이 응답에 누출하는 "생각" 텍스트를 제거하는 작은 프록시
• Temporal — 페이퍼 트레이딩 일정을 구동하는 워크플로우 엔진(선택적 fin 프로필을 활성화한 경우에만)

자체 LLM 키(DeepSeek, Claude, Qwen, Gemini 등)를 가져오거나 HunterCode의 내장 할당량(일일 토큰 할당이 있는 무료 키)을 사용할 수 있습니다. 데이터는 무료 오픈 소스 소스(AKShare, yfinance), 자체 MCP 서버, 또는 프로젝트의 플랫폼 데이터 파이프라인에서 가져올 수 있습니다.

주목할 만한 설계 세부 사항

• 설정 마법사: 처음 열 때 5단계 마법사가 6개 서비스 모두가 정상인지 확인하고, 모델을 선택하게 하고, 연결 및 도구 호출을 실시간으로 테스트하고(실패하는 구성은 저장할 수 없음), 데이터 소스를 구성합니다.
• 보안: 인스턴스가 공개 인터넷에 노출된 경우 설정 토큰을 설정하여 임의의 방문자가 LLM을 구성하지 못하게 할 수 있습니다. argon2id 비밀번호 해시를 사용한 JWT 인증.
• 감사 추적: 완전한 감사 로그(AUDIT.jsonl)가 활동을 기록합니다.
• 자기 진화(선택 사항): "개인 배포" 모드를 사용하면 시스템이 자체 거래 후 검토에서 학습하고 전략 변경을 제안할 수 있지만, 변경 사항은 섀도우 검증을 거쳐 인간의 확인 후에만 적용됩니다. 실제 거래는 하드 비활성화됩니다.

결론

HunterCode는 실질적이고 진정으로 기능하는 오픈 소스 프로젝트입니다. 금융 조사를 위한 자체 호스팅 AI 에이전트 시스템으로, 실제 LLM 도구 호출, MCP 통합, 스킬 시스템, 예측, 신중하게 격리된 페이퍼 트레이딩 시뮬레이션을 갖추고 있습니다. 래퍼 데모나 링크 모음이 아니라 실제 엔지니어링이 뒷받침된 배포 가능한 제품입니다.