주식 분석을 AI로 보조하려는 사용자｜AI Hedge Fund 설치·분석 흐름·비용
주식 하나 알아보려는데 실적도 찾아야 하고, 투자 전략도 비교해야 하죠. 이런 분석을 AI에게 맡겨보는 도구가 있습니다. 깃허브에 공개된 AI Hedge Fund입니다. 종목과 전략을 정해 분석하고, 과거에는 어떤 결과가 나왔을지 시험해 볼 수 있습니다.
한마디로, AI와 함께 투자 전략을 공부하는 실험 도구입니다. 어디에 쓸모가 있는지, 시작하려면 무엇이 필요한지 차근차근 살펴보겠습니다.
AI Hedge Fund, 어떤 도구인가요?
현재 공식 안내에서는 종목·전략·리밸런싱 주기를 설정하고, 저장한 전략을 백테스트하는 기능을 소개합니다. 백테스트는 “이 전략을 과거에 썼다면 어떤 결과가 나왔을까?”를 살펴보는 작업입니다. 리밸런싱은 정해 둔 기준에 맞춰 투자 비중을 다시 조정하는 뜻이고요.
웹사이트에서 버튼 하나만 누르는 서비스보다는, 내 컴퓨터의 터미널에서 실행하는 프로그램에 가깝습니다. 공식 깃허브에서 기능과 코드를 확인할 수 있습니다.
이럴 때 활용해 보세요
| 궁금한 것 | 해볼 작업 |
|---|---|
| AI는 어떤 근거로 판단할까? | 분석 결과와 사용한 데이터를 함께 읽기 |
| 전략을 바꾸면 결과도 달라질까? | 종목은 같게 두고 전략 조건 비교하기 |
| 과거에도 괜찮았던 전략일까? | 기간을 나눠 백테스트 살펴보기 |
처음에는 잘 아는 기업을 대상으로 시작해 보세요. 낯선 기업보다 숫자와 설명을 읽기 쉽고, AI가 정리한 내용에서 무엇을 더 확인해야 할지도 눈에 들어옵니다.
무료인가요? 설치비와 사용 비용은 따로 보세요
프로그램은 MIT 라이선스로 공개되어 있습니다. 다만 실행에는 금융 데이터 API 키와 AI 모델 API 키가 필요합니다. API 키는 프로그램이 해당 서비스를 이용할 때 쓰는 개인 접속 열쇠라고 생각하면 됩니다. 금융 데이터는 Financial Datasets를 사용하며, AI 모델은 지원 제공업체 중에서 선택합니다.
따라서 “오픈소스니까 실행도 무조건 무료”는 아닙니다. 결제 전에는 원하는 종목의 데이터 제공 여부, 무료 범위, 사용량에 따른 비용을 확인하세요. 첫 실험은 종목과 기간을 작게 잡고 사용량을 확인한 뒤 넓히는 편이 부담이 적습니다.
설치는 이렇게 시작합니다
아래는 공식 README의 설치 방법입니다. pipx가 준비된 환경에서 설치한 뒤 실행하면 됩니다. pipx가 없다면 먼저 pipx 공식 설치 안내에서 운영체제에 맞는 준비를 해주세요.
pipx install aihf
aihf프로그램에서 필요한 시점에 API 키를 입력하고 진행합니다. 키는 공식 안내상 ~/.hedge-fund/.env에 저장되므로 이 파일이나 키가 보이는 화면은 공개하지 마세요. 설치 명령이 인식되지 않는다면 터미널을 다시 열고 pipx 설치와 실행 경로부터 확인하면 됩니다.
첫 실행은 ‘작은 비교 실험’으로
- 살펴볼 종목을 정합니다. 데이터가 지원되는지 먼저 확인하세요.
- 전략과 주기를 설정합니다. 처음에는 조건을 복잡하게 늘리지 않는 것이 좋습니다.
- 결과에서 근거를 읽습니다. 평가만 보지 말고 자료 날짜와 핵심 숫자를 함께 살펴보세요.
- 한 가지 조건만 바꿔 비교합니다. 여러 조건을 동시에 바꾸면 무엇 때문에 달라졌는지 알기 어렵습니다.
- 비교 내용을 기록합니다. 종목·기간·설정·결과·API 사용량을 남겨두면 다음 실험이 쉬워집니다.
예를 들어 같은 종목과 기간을 유지한 채 전략만 바꿔 보는 식입니다. 결과가 좋았던 경우뿐 아니라 잘 맞지 않았던 경우도 함께 기록하세요. 백테스트를 읽을 때는 수익률 외에 거래비용 반영 여부와 비교 기준도 확인하면 도움이 됩니다.
시작 전에 궁금한 세 가지
국내 주식도 되나요?
한국 종목 지원 범위는 이 글에서 확인하지 못했습니다. 국내 주식에 쓸 계획이라면 API 결제 전에 해당 종목과 필요한 재무 데이터가 제공되는지 확인하세요.
자동으로 주식을 사고파나요?
현재 README에는 실제 거래를 실행하지 않는다고 안내되어 있습니다. 앞으로의 개발 계획과 현재 기능을 구분해서 보시면 됩니다.
누구에게 잘 맞나요?
AI 분석과 투자 전략을 직접 실험해 보고 싶은 분에게 어울립니다. 반대로 설치나 API 설정 없이 간단한 종목 정보만 보고 싶다면 익숙한 증권 앱의 기업 정보부터 활용하는 편이 간편합니다.
분석 결과보다 ‘이유’를 읽어보세요
AI Hedge Fund를 써볼 때 가장 재미있는 부분은 AI가 어떤 자료를 보고 판단했는지 따라가는 것입니다. 처음부터 거창하게 시작할 필요는 없습니다. 익숙한 종목으로 작은 실험 하나를 해보고, 기업 공식 실적 자료와 숫자를 대조해 보세요.
교육·연구용 도구이며, 분석 결과는 참고용으로 수익을 보장하지 않습니다.
공식 안내: 프로젝트·설치 방법 · 금융 데이터 API
확인일: 2026년 9월 23일 · 공식 문서 기준 기능 소개