TradingAgents: LLM 기반 금융 트레이딩 프레임워크 설치 및 Docker 활용 가이드

TradingAgents: LLM 기반 금융 트레이딩 프레임워크 설치 가이드

TradingAgents는 LLM을 활용한 금융 트레이딩 자동화를 위한 강력한 프레임워크입니다. 본 가이드에서는 개발 환경 설정부터 Docker를 이용한 실행까지 단계별로 안내합니다.

1. 개발 환경 설정

1.1. 저장소 복제 및 디렉토리 이동

먼저 GitHub 저장소를 로컬 환경으로 복제하고 해당 디렉토리로 이동합니다.

git clone https://github.com/TauricResearch/TradingAgents.git
cd TradingAgents

1.2. Python 가상 환경 생성 및 활성화

TradingAgents는 Python 3.11 이상 버전을 요구합니다. 선호하는 가상 환경 관리 도구를 사용하여 환경을 설정합니다. 여기서는 conda와 uv를 사용한 예시를 보여줍니다.

• Conda 사용 시:

  conda create -n tradingagents python=3.13
  conda activate tradingagents
  

• uv 사용 시:

  uv venv --python 3.13
  source .venv/bin/activate
  

1.3. 패키지 설치

가상 환경이 활성화된 상태에서 TradingAgents와 필요한 의존성을 설치합니다. pip 또는 uv를 사용할 수 있습니다.

• pip 사용 시:

  pip install .
  

• uv 사용 시:

  uv pip install .
  

2. Docker를 이용한 실행

Docker를 사용하면 환경 설정 없이 TradingAgents를 간편하게 실행할 수 있습니다.

2.1. 기본 실행

.env 파일 예시를 복사하여 API 키를 설정한 후 Docker Compose를 실행합니다.

cp .env.example .env  # API 키를 .env 파일에 추가하세요.
docker compose run --rm tradingagents

저장소를 업데이트한 후에는 Docker 이미지를 다시 빌드해야 합니다.

docker compose build

2.2. 데이터 저장 위치 변경 (선택 사항)

결과, 보고서, 메모리 로그 등은 기본적으로 tradingagents_data 볼륨에 저장됩니다. 호스트 머신의 특정 폴더에 저장하려면 .env 파일 또는 쉘 환경 변수를 통해 TRADINGAGENTS_DATA_DIR을 설정합니다.

mkdir -p data
TRADINGAGENTS_DATA_DIR=./data docker compose run --rm tradingagents

2.3. Ollama 로컬 모델 사용

Ollama를 사용하여 로컬 LLM 모델을 실행하려면 다음 명령어를 사용합니다.

docker compose --profile ollama run --rm tradingagents-ollama

3. 필수 API 키 설정

TradingAgents는 다양한 LLM 제공자를 지원합니다. 사용하려는 LLM 제공자의 API 키를 환경 변수로 설정해야 합니다. 아래는 몇 가지 예시입니다.

export OPENAI_API_KEY=...
export GOOGLE_API_KEY=...
export ANTHROPIC_API_KEY=...
# 기타 API 키들도 필요에 따라 설정

## 활용 사례

1. 신규 API 키 설정 후 첫 실행 시 막히는 경우

• 누가: 신규 사용자
• 무엇을 하려다 막혔는지: OpenAI API 키를 설정했지만, docker compose run --rm tradingagents 명령 실행 시 API 인증 오류가 발생합니다.
• 발췌의 어떤 단계를 썼는지: "2.1. 기본 실행" 섹션의 cp .env.example .env 명령어를 사용하여 .env 파일을 생성하고, 해당 파일 안에 OPENAI_API_KEY=sk-xxxxxxxxxxxx 와 같이 정확한 API 키를 입력했는지 확인합니다. 또한, export OPENAI_API_KEY=... 와 같이 환경 변수로도 설정했는지 다시 한번 확인합니다. (Docker Compose 실행 시 .env 파일의 내용이 자동으로 로드될 수 있으나, 명시적인 환경 변수 설정이 더 확실할 수 있습니다.)
• 끝나면 무엇이 달라지는지: API 키 설정이 올바르게 적용되어 TradingAgents가 정상적으로 LLM API에 접근하고 트레이딩 로직을 실행할 준비가 됩니다.

2. 로컬 LLM 모델을 사용하여 테스트하고 싶은 경우

• 누가: 로컬 환경에서 LLM을 테스트하고 싶은 개발자
• 무엇을 하려다 막혔는지: 외부 LLM API 사용 비용 없이 Ollama로 실행 중인 로컬 LLM을 TradingAgents와 연동하여 테스트하고 싶습니다.
• 발췌의 어떤 단계를 썼는지: "2.3. Ollama 로컬 모델 사용" 섹션의 docker compose --profile ollama run --rm tradingagents-ollama 명령어를 실행합니다. Ollama가 로컬에서 실행 중이고, .env 파일 또는 환경 변수를 통해 OLLAMA_BASE_URL 등이 올바르게 설정되어 있는지 확인합니다. (예: OLLAMA_BASE_URL=http://host.docker.internal:11434)
• 끝나면 무엇이 달라지는지: TradingAgents가 외부 API 대신 로컬에서 실행 중인 Ollama 모델과 통신하여 금융 트레이딩 시뮬레이션을 수행하게 됩니다. 이를 통해 비용 부담 없이 모델 성능을 검증하고 개발할 수 있습니다.