TradingAgents는 여러 AI가 토론해 주식을 분석·모의 매매하는 연구용 실험이며, 절대 투자 조언이 아니니 실제 매매 판단에 쓰지 마세요.
0. TradingAgents가 뭔가요
여러 AI가 '작은 증권사 팀'처럼 모여 주식을 분석하고 모의로 매매해 보는 실험 도구입니다.
- Agent에이전트
- 특정 역할(애널리스트·트레이더 등)을 맡아 스스로 판단하고 글을 쓰는 AI 한 명. 여러 명이 모여 한 팀이 됩니다.
- Paper / simulated trading모의 매매
- 실제 돈이나 진짜 주문 없이, 가짜 장부 위에서만 사고파는 연습. 손해도 이득도 진짜가 아닙니다.
- API keyAPI 키
- 이 도구가 AI 모델(ChatGPT 등)이나 주가 데이터를 불러오려고 쓰는 '출입증' 같은 비밀번호. 보통 직접 발급받아 넣어야 합니다.
누구에게, 왜 흥미로운가
투자 비법이 아니라 'AI 여러 대가 협업하는 방식'을 구경하는 학습 도구입니다.
이 도구가 보여주는 진짜 가치는 'AI 여러 대가 어떻게 역할을 나눠 협업하는가'를 눈으로 보는 데 있습니다. 주식은 그 협업을 보여주기 위한 예시 주제일 뿐입니다.
- AI 협업이 궁금한 사람 — 한 AI에게 다 시키는 것과, 역할을 나눠 토론시키는 것이 어떻게 다른지 체감할 수 있습니다.
- 금융 데이터에 관심 있는 사람 — 분석·반대의견·리스크 점검이 어떤 순서로 오가는지 흐름을 볼 수 있습니다.
- AI 에이전트 개념을 배우는 사람 — '에이전트', '토론', '리스크 게이트' 같은 개념의 실제 예시를 만날 수 있습니다.
반대로, 돈을 벌 종목을 찍어주는 도구를 기대했다면 맞지 않습니다. 이건 그런 도구가 아닙니다.
AI 여러 대가 분석했다니까, 여기서 '매수'라고 하면 사도 되는 거 아닌가요?
아닙니다. 이건 연구용 실험이라 결과가 모델·데이터·설정에 따라 매번 달라지고, 공식 문서도 '투자 조언이 아니다'라고 못박았습니다. 화면의 어떤 결론도 실제 매매 근거로 쓰면 안 됩니다. AI 협업 과정을 '구경'하는 용도로만 보세요.
어떻게 돌아가나 — 역할을 나눠 토론한다
분석 → 찬반 토론 → 매매 제안 → 리스크 점검, 이 순서로 AI들이 손을 거칩니다.
1. 애널리스트들이 자료를 모은다
펀더멘털(기본 재무)·뉴스·시장 분위기(센티먼트)·차트(기술적)를 각각 맡은 애널리스트 AI들이 한 종목을 살펴 보고서를 씁니다.
2. 리서처 둘이 찬반 토론을 한다
'긍정적으로 보는 AI(불)'와 '부정적으로 보는 AI(베어)'가 서로 반박하며 좋은 점과 위험을 동시에 끌어냅니다.
3. 트레이더 AI가 매매안을 낸다
앞의 보고서와 토론을 종합해 '이렇게 모의 매매하면 어떨까' 하는 제안을 만듭니다. 어디까지나 가짜 장부 위 제안입니다.
4. 리스크·포트폴리오 담당이 점검한다
마지막으로 리스크 팀이 위험을 다시 따지고, 포트폴리오 매니저가 그 제안을 통과시키거나 막습니다. 사람이 결재 라인에서 한 번 더 거르는 모습과 닮았습니다.
솔직히 — 설치와 비용 장벽이 있습니다
이건 클릭 한 번 도구가 아니라, 설치와 API 키가 필요한 작업입니다.
비개발자에게 정직하게 말하면, TradingAgents는 웹사이트에 들어가 바로 쓰는 도구가 아닙니다. 컴퓨터에 내려받아 설치하고, AI 모델·데이터용 비밀 키를 직접 넣어야 돌아갑니다. 이 점을 숨기지 않겠습니다.
- 설치가 필요 — 코드를 내려받아(
git clone) 파이썬 환경을 만들고 설치(pip install .)하거나, 도커(Docker)로 띄우는 과정이 있습니다. 명령어 입력에 익숙하지 않다면 진입 장벽이 있습니다. - 설치 후엔 대화형 메뉴 — 설치만 끝내면
tradingagents명령으로 뜨는 대화형 화면에서 종목·날짜·모델을 골라 실행하는 식이라, 첫 설치 고비만 넘기면 조작 자체는 비교적 단순합니다. - API 키가 필요 — AI 모델(예: OpenAI 등)과 주가 데이터(예: Alpha Vantage) 같은 서비스의 키를 발급받아 넣어야 합니다.
- 비용은 '내가 쓴 만큼' — 프레임워크 자체는 무료·오픈소스(Apache-2.0)입니다. 설명만 '읽을' 때는 돈이 들지 않지만, 키를 넣고 실제로 실행하면 연결한 AI 모델·데이터 서비스에 사용량만큼 요금이 붙을 수 있습니다. 플랜·사용량에 따라 다릅니다.
| 항목 | 솔직한 현실 | 비개발자라면 |
|---|---|---|
| 프레임워크 비용 | 무료·오픈소스(Apache-2.0) | 내려받는 것 자체는 공짜 |
| 연결 서비스 비용 | 실행 시 AI 모델·데이터에 사용량 과금(변동) | 읽기만 하면 무료, 돌리면 요금이 붙을 수 있음 |
| 설치 난이도 | 명령어·파이썬 환경 또는 도커가 필요한 작업 | 혼자 어렵다면 무리해서 설치하지 말 것 |
| 가장 쉬운 입구 | 공식 저장소 화면·설명을 '읽어보기' | 직접 안 돌려도 개념은 충분히 배울 수 있음 |
안전하게 — 절대 투자 판단에 쓰지 마세요
이건 학습용 실험이고, 화면 결론은 실제 매매의 근거가 될 수 없습니다.
쓰기 전 마음에 새길 것
- 여기서 나온 종목·매매 결론을 실제 투자 판단에 쓰지 않는다
- 수익·수치·확률을 단정하는 표현은 모두 의심한다 (결과는 매번 변동된다)
- 남에게 '이 도구가 추천했다'며 종목을 권하지 않는다 (오해·피해를 부른다)
- 본인이 직접, 학습 목적으로만 살펴본다
- API 키는 비밀번호이므로 절대 화면 공유·공개 게시물에 노출하지 않는다
오늘 해볼 것 — 부담 없이 한 걸음
설치 없이 '읽기'부터, 개발이 익숙하면 공식 순서대로 한 번만.
1단계 — 공식 저장소 열어 읽기
GitHub의 TradingAgents 저장소에 들어가 설명(README)을 훑어보며 '애널리스트 → 리서처 토론 → 트레이더 → 리스크 점검'으로 이어지는 흐름을 그림으로 잡습니다. 여기까지는 누구나, 무료로 가능합니다.
2단계 — '연구·교육용' 면책을 직접 확인
저장소 안 면책(disclaimer) 문구를 직접 찾아 읽으세요. '투자 조언이 아니다'라는 점을 본인 눈으로 확인하는 게 첫 번째 안전장치입니다.
3단계(선택) — 익숙하면 설치 시도
명령어가 익숙하다면 공식 안내대로 코드를 내려받아(git clone) 파이썬 환경을 만들고 설치(pip install .)하거나 도커로 띄웁니다. README의 설치 명령을 그대로 따르세요.
4단계(선택) — 키 넣고 모의로만 돌려보기
필요한 API 키를 발급해 넣고
tradingagents대화형 메뉴에서 한 종목으로 '토론 과정'을 구경합니다. 결과는 학습용으로만 보고, 절대 실제 매매에 쓰지 않습니다.
- 설치가 막막하면 무리하지 말고 '읽기'에서 멈추기 — 개념 이해엔 그걸로 충분합니다
- 직접 돌렸다면, 같은 종목을 다시 실행해 결과가 달라지는지 비교하며 '비결정적'을 체감하기
- API 키는 화면 캡처·공유에서 반드시 가리기
| 이걸 했으면 첫걸음 끝 | 확인 |
|---|---|
| 공식 저장소에서 '분석→토론→매매안→리스크 점검' 흐름을 훑어봤다 | ☐ |
| '연구·교육용, 투자 조언 아님' 면책 문구를 직접 확인했다 | ☐ |
| 이 도구가 설치·API 키가 필요한 작업임을 이해했다 | ☐ |
| 화면 결론을 실제 투자에 쓰지 않겠다고 마음먹었다 | ☐ |
자주 묻는 질문
이 도구가 추천한 종목, 실제로 사도 되나요?
안 됩니다. TradingAgents는 연구·교육용 실험이며, 공식 문서도 '금융·투자·매매 조언이 아니다'라고 분명히 밝혔습니다. 화면에 '매수/매도'가 떠도 그것은 AI들이 만든 가상의 결과일 뿐, 실제 매매의 근거가 될 수 없습니다. 투자 판단에는 절대 사용하지 마세요.
실제 돈으로 매매가 되나요?
아닙니다. 기본적으로 '모의(가짜) 매매'만 합니다. 진짜 주문이나 실제 자금이 오가지 않고, 가상의 장부 위에서만 사고파는 연습입니다. 손해도 이득도 진짜가 아닙니다.
비개발자도 바로 쓸 수 있나요?
바로는 어렵습니다. 웹사이트에서 클릭만 하면 되는 도구가 아니라, 컴퓨터에 코드를 내려받아 설치(또는 도커로 실행)하고 AI·데이터용 API 키를 직접 넣어야 합니다. 설치만 끝내면 메뉴를 고르는 대화형 화면이 떠서 조작 자체는 단순한 편이지만, 첫 설치 고비가 있습니다. 명령어가 익숙하지 않다면, 직접 돌리기보다 공식 저장소 설명을 '읽어보는 것'만으로도 개념은 충분히 배울 수 있습니다.
비용은 얼마인가요?
프레임워크 자체는 무료·오픈소스(Apache-2.0)입니다. 설명만 읽을 때는 비용이 들지 않지만, 키를 넣고 실제로 실행하면 연결해 쓰는 AI 모델이나 주가 데이터 서비스에 사용량만큼 각각 요금이 붙을 수 있습니다. 플랜·사용량에 따라 다르므로 단정할 수 없고, 변동됩니다.
같은 종목인데 결과가 매번 다른 이유가 뭔가요?
이 도구는 '비결정적' 실험이기 때문입니다. 공식 문서도 성과가 어떤 AI 모델을 쓰는지, 모델 설정(온도)·분석 기간·데이터 품질 등 여러 요인에 따라 달라진다고 밝혔습니다. 그래서 한 번 나온 화면을 일반적인 사실이나 정답으로 받아들이면 안 됩니다.
API 키를 넣을 때 주의할 점이 있나요?
API 키는 비밀번호와 같습니다. 화면 공유·캡처·공개 게시물에 절대 노출하지 마세요. 노출되면 남이 내 키로 비용을 쓰거나 악용할 수 있습니다. 키는 안전하게 보관하고, 필요 없어지면 발급처에서 폐기하세요.
출처와 확인 경계
기능·설치 방식·필요한 API 키·면책 내용은 TradingAgents 공식 GitHub 저장소와 README를 기준으로 정리했습니다(2026-06-07 기준). 화면·명령어·필요한 키 종류는 업데이트로 바뀔 수 있으니 아래 단계는 큰 흐름으로 참고하세요. 공식 문서는 이 도구가 '연구 목적이며 투자·금융·매매 조언이 아니다'라고 분명히 밝히고 있고, 결과는 모델·설정·데이터에 따라 달라지는 비결정적 실험입니다 — 어떤 화면도 그대로 믿지 말고 본인이 한 번 더 확인하세요.