TradingAgents는 여러 AI 역할을 협력시켜 주식 연구 과정을 정리하는 도구입니다. 공식 절차에 따라 설치와 설정을 마친 뒤 첫 실행을 해보되, 결과는 투자 판단의 참고 자료로만 다루세요. 수익이나 예측 정확도를 보장하는 자동 매매 도구로 보면 안 됩니다.
이번 주에는 공식 저장소의 실행 조건을 먼저 확인하고, 가상 환경에서 설치한 다음 문서의 예제를 실행해 출력과 로그를 검토하세요. 이 안내는 TradingAgents의 기능을 살펴보려는 투자자, 처음 설치하려는 개발자, AI 에이전트 실행 환경을 평가하는 기술 담당자에게 적합합니다.
TradingAgents의 협업 분석과 자동 매매는 다릅니다
프로젝트 안내는 분석 역할을 나누고, 각 역할의 결과를 모아 토론과 의사 결정 과정에 활용하는 흐름을 설명합니다. 주식 분석을 여러 단계로 나누어 살펴볼 수 있다는 뜻이지, 앞으로의 가격을 확정하거나 거래를 자동 실행한다는 뜻은 아닙니다. 프로젝트의 역할과 실행 예시에서 현재 설명을 확인하세요.
연구 논문도 여러 에이전트를 활용하는 분석 틀을 다룹니다. 논문 등록 정보는 2024년 12월로 확인되며, 연구 자료는 도구의 설계 배경을 파악하는 참고 자료입니다. 특정 종목의 결과가 실제로 맞을지 보증하는 근거로 해석해서는 안 됩니다. 연구 논문과 등록 정보를 함께 읽어보면 기능 설명과 연구 맥락을 구분하기 쉽습니다.
설치 전에 로컬 실행과 원격 실행을 비교하세요
실행 환경은 프로젝트의 공식 요구 조건에 맞춰야 합니다. 원격 환경이 편리하다는 이유만으로 특정 운영 체제나 장비가 반드시 필요하다고 가정하지 마세요. 현재 호환 조건은 저장소 설정 파일과 설치 안내에서 확인해야 합니다.
| 실행 방식 | 맞는 경우 | 먼저 확인할 점 |
|---|---|---|
| 내 컴퓨터에서 실행 | 설치와 디버깅을 직접 관리하고 싶을 때 | 파이썬 조건, 의존성 충돌, 로컬 보안 설정 |
| 원격 환경에서 실행 | 개인 컴퓨터와 작업 환경을 분리하고 싶을 때 | 접속 방식, 파일 보관 위치, 비밀 키 관리 |
| 맥 환경에서 실행 | 작업 흐름에 macOS가 실제로 필요할 때 | 프로젝트가 요구하는 조건과 원격 환경의 제공 내용 |
가상 환경은 프로젝트별 파이썬 패키지를 분리하는 데 쓰입니다. 파이썬 문서는 venv가 별도의 가상 환경을 만드는 표준 도구라고 설명합니다. 가상 환경의 생성과 사용 안내를 참고해 시스템 전체에 패키지를 섞어 설치하지 마세요.
| 확인 항목 | 공식 자료에서 볼 위치 | 설치 전 판단 |
|---|---|---|
| 파이썬 조건 | 프로젝트의 pyproject.toml |
현재 설치 환경이 요구 조건에 맞는지 확인 |
| 의존성 설치 | 저장소의 설치 안내와 의존성 파일 | 문서에 적힌 설치 경로를 선택 |
| 환경 변수 | .env.example |
필요한 서비스 설정과 비밀 키 확인 |
| 기본 동작 설정 | default_config.py |
기본값과 변경 가능한 항목 구분 |
프로젝트 설정 파일에는 파이썬 요구 조건이 기록됩니다. 설치 전에 현재 프로젝트의 파이썬 요구 조건을 확인하세요. 기억에 의존해 버전을 정하거나, 다른 프로젝트의 설치 명령을 가져오면 의존성 오류를 찾기 어려워집니다.
첫 단계: 저장소를 내려받고 환경을 분리하세요
명령은 터미널에서 실행합니다. 아래 저장소 주소와 설치 방식은 프로젝트의 공식 안내를 기준으로 합니다.
git clone https://github.com/TauricResearch/TradingAgents.git
cd TradingAgents
python -m venv .venv
저장소를 복제하는 명령의 동작은 Git의 복제 명령 안내에 설명되어 있습니다. 가상 환경을 만든 뒤에는 사용 중인 터미널에 맞는 활성화 명령을 파이썬 문서에서 확인하세요. 운영 체제와 셸에 따라 활성화 방식이 다르므로, 다른 환경용 명령을 그대로 붙여 넣지 않는 편이 안전합니다.
다음 단계: 공식 안내대로 의존성을 설치하세요
가상 환경을 활성화한 상태에서 프로젝트의 설치 안내를 확인하세요. README에 요구 사항 파일을 설치하는 방식이 제시된 경우에는 다음 명령을 사용합니다.
python -m pip install -r requirements.txt
이 명령은 프로젝트에 기록된 의존성을 설치합니다. 설치 중 오류가 나면 마지막 줄만 보지 말고, 처음 실패한 패키지와 파이썬 조건을 함께 확인하세요. 로컬 프로젝트를 pip로 설치하는 방식은 pip의 로컬 프로젝트 설치 안내에서 확인할 수 있습니다. 현재 저장소에 안내된 설치 방식이 다르면 저장소의 최신 설명을 우선하세요.
설치가 끝났다고 판단하기 전, 명령이 오류 없이 마무리됐는지 확인하고 같은 가상 환경 안에서 파이썬과 pip가 실행되는지 점검하세요. 시스템 환경에 설치된 패키지와 가상 환경의 패키지가 섞이면 설치 성공 여부를 잘못 판단할 수 있습니다.
설정 파일과 비밀 키는 용도를 나눠 확인하세요
프로젝트의 환경 변수 예시 파일은 외부 서비스 연결에 필요한 설정 항목을 확인할 때 참고합니다. 기본 설정 파일은 분석 흐름의 초기 설정을 살펴볼 때 사용합니다. 둘은 역할이 다르므로 하나의 파일에 모든 설정이 들어 있다고 가정하지 마세요.
.env.example을 참고해 로컬 설정 파일을 준비하더라도, 항목을 임의로 추가하거나 값의 형식을 추측하지 마세요. 각 항목이 필수인지 선택 사항인지는 파일의 주석과 현재 프로젝트 안내로 확인합니다. API 키와 같은 민감한 값은 공개 저장소에 커밋하지 마세요. 설정 파일을 공개하거나 로그에 비밀 값이 출력되지 않는지도 실행 전에 살펴보세요.
첫 실행은 문서 예제를 그대로 재현하세요
README에 있는 파이썬 예시는 종목 코드 NVDA와 날짜 2024-05-10을 입력하고, 실행 결과로 final_state와 decision 두 값을 받습니다. 이는 문서의 예시 입력과 결과 형태이지, 현재 분석에 권장되는 종목이나 날짜라는 뜻은 아닙니다. 공식 실행 예시를 복사해 구조를 확인한 뒤, 실제 실행에 필요한 설정을 먼저 맞추세요.
예시 코드에 쓰인 실행 방식이 현재 저장소 상태와 일치하는지 확인하고, 코드가 반환한 결과와 터미널 로그를 함께 살펴보세요. 성공 여부는 단순히 명령이 끝났는지만으로 판단하지 마세요. 입력 종목과 날짜가 의도한 값인지, 결과에 필요한 분석 내용이 들어 있는지, 데이터 연결 오류가 기록되지 않았는지도 확인해야 합니다. 문서의 예시 출력은 분석 결과를 읽는 방법을 익히는 자료일 뿐, 매수나 매도 권고가 아닙니다.
막혔을 때는 환경에서 출력 방향으로 점검하세요
처음부터 설정을 여러 개 바꾸면 원인을 찾기 어렵습니다. 다음 순서로 하나씩 확인하세요.
- 의존성 오류라면 가상 환경이 활성화되어 있는지, 프로젝트가 요구하는 파이썬 조건과 설치 명령이 맞는지 확인합니다.
- 설정 오류라면
.env.example의 변수 이름과 실제 로컬 설정을 대조합니다. 키 값을 공개 채팅이나 코드에 붙여 넣지 마세요. - 연결 오류라면 필요한 계정, 접근 권한, 외부 서비스 상태를 확인합니다. 연결 가능 여부를 코드 오류와 분리해 살펴보세요.
- 출력이 없거나 불완전하다면 입력값과 실행 로그를 다시 확인하고, 공식 예제와 호출 형태가 같은지 비교합니다.
환경을 바꿔도 오류가 이어지면 처음 실패한 로그와 사용한 명령을 기록한 뒤, 프로젝트 문서에서 해당 조건을 찾아보세요. AI 에이전트를 내 컴퓨터와 원격 환경 중 어디에서 실행할지 판단하는 데에는 AI 에이전트 실행 환경 안내가 참고가 될 수 있습니다. 설치 환경과 설정 문제를 분리해 확인하려면 도움말 안내도 살펴보세요.
첫 실행 전후로 확인할 항목
- [ ] 프로젝트 설정 파일에서 파이썬 조건을 확인했습니다.
- [ ] 프로젝트별 가상 환경을 만들고 활성화했습니다.
- [ ] 공식 설치 안내에 맞는 의존성 설치를 마쳤습니다.
- [ ] 환경 변수 예시와 기본 설정 파일을 구분해 읽었습니다.
- [ ] 비밀 키를 공개 저장소에 올리지 않도록 확인했습니다.
- [ ] 실행 로그와 결과의 완전성을 확인하고, 분석을 투자 판단과 구분했습니다.
FAQ에서 다룬 설치 준비, 설정, 기능과 실패 점검을 모두 확인해도 프로젝트 요구 조건에 맞지 않는다면, 먼저 실행 환경을 바꾸기보다 문서에 적힌 조건과 현재 컴퓨터 상태의 차이를 찾으세요. TradingAgents는 연구 과정을 보조하지만 투자 판단의 책임을 대신하지 않습니다.
로컬 실행은 파일과 개발 도구를 직접 관리할 수 있지만, 컴퓨터의 절전이나 네트워크 중단, 패키지 충돌을 스스로 처리해야 합니다. 원격 실행은 개인 컴퓨터와 작업 환경을 분리할 수 있지만, 접속 방식과 데이터 보관 조건을 확인해야 합니다. macOS가 필요한 작업이라면 Hashvps에서 확인할 수 있는 제공 정보를 먼저 살펴보고, 현재 환경과 맞는 조건이 확인될 때만 맥 대여를 검토하세요. 이 프로젝트를 실행하는 데 클라우드 맥이 필수인 것은 아닙니다.
주식 분석 환경을 원격 맥에서 꾸려 보세요
Hashvps의 애플 실리콘 맥 미니를 대여해 파이썬 기반 분석 도구를 실행할 전용 환경을 마련할 수 있습니다.
원격 데스크톱과 명령줄 접속을 함께 활용해 설치부터 실행, 점검까지 편리하게 진행할 수 있습니다.