AI가 주식 매수·매도 결정을 내리는 과정을 터미널에서 지켜보는 교육용 시뮬레이터
실제 돈을 움직이지 않고, 여러 AI 모델이 투자자 역할을 맡아 시장 데이터를 분석하고 매매 결정을 내리는 과정을 직접 확인할 수 있습니다. 이 도구는 AI가 어떻게 판단을 내리는지 이해하기 위한 학습용 환경으로, 실제 거래는 수행하지 않습니다. 가상 자금으로 운용되는 펀드의 기록을 통해 트레이딩 로직의 흐름을 파악할 수 있습니다.
가상 자금으로 운용되는 페이퍼 트레이딩
터미널 앱의 기본 모드는 페이퍼 트레이딩입니다. 실제 시장 데이터와 가상 자금을 결합해 펀드를 운용하며, 각 펀드는 실제 시장 일자와 가상 자금의 이력을 기록한 장부를 유지합니다. 실행 전 AI가 내릴 결정을 미리 보여주는 승인 단계가 있어 어떤 판단이 내려지는지 투명하게 확인할 수 있습니다. 모든 세션은 해시 체인으로 연결된 기록에 추가되어, 자산 가치의 변화가 초기화되지 않고 누적된 성과로 남습니다. s 키로 전체 세션 이력을, h 또는 r 키로 즉시 중단할 수 있습니다.
과거 데이터로 전략을 되돌려 보는 백테스팅
펀드를 과거 데이터로 다시 실행해 전략의 반응을 점검하는 백테스팅 모드도 지원합니다. 펀드 정의에는 특정 종목 목록이 포함되지 않으며, 백테스트를 실행할 때 매번 분석할 종목 범위를 선택합니다. 실행 결과로 자산 곡선이 벤치마크와 비교되어 그려지며, 연구 결과는 로컬 디렉터리에 저장됩니다. 이를 통해 특정 전략이 과거 시장 환경에서 어떻게 반응했는지 시각적으로 파악할 수 있습니다.
설치와 API 키 설정
설치는 pipx install aihf 명령으로 완료됩니다. 실행 시 필요한 API 키는 처음 사용 시점에 요청하며, ~/.hedge-fund/.env 파일에 자동 저장됩니다. 금융 데이터 API 키와 AI 모델 API 키가 필요하며, Anthropic, OpenAI, DeepSeek, Google, xAI, Kimi, TypeSafe(Jev) 중 하나를 선택할 수 있습니다. 셸에 이미 환경 변수로 설정된 키가 있다면 저장된 파일보다 우선 적용됩니다.
실전 투자에 사용할 수 없는 이유
이 프로젝트는 교육 및 연구 목적으로만 개발되었으며, 실제 투자 조언이나 수익 보장을 제공하지 않습니다. 개발자는 금융 손실에 대한 책임을 지지 않으며, 투자 결정은 반드시 재무 전문가와 상의해야 합니다. 과거 성과가 미래 결과를 보장하지 않는다는 점을 명심해야 합니다. MIT 라이선스로 배포되어 자유롭게 학습과 연구에 활용할 수 있지만, 실전 트레이딩 시스템으로 전환하려는 의도로 접근해서는 안 됩니다.
