Echolon

📖 English · 简体中文

선물 연구를 위한 LLM 에이전트 네이티브 백테스트 프레임워크. MCP 서버, 22개의 패키지 내 스킬, 32개의 카탈로그화된 오류 코드, 타입이 지정된 Pydantic 설정을 제공합니다. 에이전트는 산문 문서에서 API 형태를 추측하는 대신 구조화된 도구를 호출합니다. 상하이선물거래소(SHFE) 일일 선물 데이터에 대한 엔드투엔드 지원을 제공합니다.

DolphinQuant의 AI 네이티브 전략 생성 제품인 Qorka의 프로덕션 엔진입니다. 매 거래일마다 SHFE에서 실제 자금으로 운용되고 있습니다.

퀵스타트

세 가지 명령어로 초보자를 위한 자연스러운 학습 과정을 다룹니다:

pip install echolon
mkdir -p ~/echolon-playground && cd ~/echolon-playground
echolon hello                  # 30-second demo

echolon hello는 약 2년 치의 알루미늄 데이터를 다운로드하고, momentum_breakout 템플릿을 스캐폴딩하며, .echolon-workspace.json을 작성하고 백테스트를 실행합니다. ./echolon-hello/strategy/baseline/entry.py를 열어 매개변수를 조정하고 echolon backtest single ./echolon-hello/strategy/baseline/으로 다시 실행하여 샤프 지수가 어떻게 변하는지 확인해 보세요.

패키지에는 minimal, momentum_breakout, rsi_mean_reversion 세 가지 템플릿이 포함되어 있습니다. echolon examples --list로 확인할 수 있으며, echolon init / echolon hello에 --template <name>을 전달하여 시작할 수 있습니다.

Linux ARM64 / Alpine / FreeBSD에서 pip install이 실패하는 경우, echolon doctor를 실행하세요. 표준 사전 빌드 휠 플랫폼(Linux x86_64, macOS x86_64+arm64, Windows x86_64; Python 3.11–3.12) 외부에서 소스 빌드가 필요할 수 있는 유일한 의존성인 ta-lib의 C 라이브러리를 진단합니다.

에이전트로 구동하기

pip install echolon                                # 1. install
claude mcp add -s user echolon -- echolon-mcp      # 2. register MCP server (user-wide)
# 3. restart Claude Code to load mcp__echolon__* tools

그런 다음 다음과 같이 요청하세요:

"구리(copper)에 대한 추세 추종 전략을 구축하고 2018년부터 2024년까지 백테스트해 줘."

백그라운드에서 에이전트는 list_skills를 호출 → patterns와 quick_start를 선택 → load_template("momentum_breakout") → list_indicators(has_lookback=True) → entry.py와 exit.py를 편집 → 모든 것이 통과될 때까지 validate_strategy_full(strategy_dir)을 반복 → 백테스트를 실행합니다. 문제가 발생하면 추적 로그에서 [CODE-NNN]을 파싱하여 get_error_doc(code)를 호출합니다. 추측할 필요가 전혀 없습니다.

Claude Code의 경우: -s user는 등록을 모든 프로젝트에 적용합니다(현재 프로젝트에만 적용하려면 제거). --는 등록 이름과 실행 명령어를 구분합니다. 한 번 실행한 후 claude mcp list를 입력하면 echolon이 연결된 stdio 서버로 표시되어야 합니다. 에이전트 오리엔테이션 가이드는 llms.txt이며, echolon init / hello에 의해 작업 공간 루트에 배치되므로 에이전트가 패키지 없이도 프로젝트를 파악할 수 있습니다.

현재 범위

엔드투엔드 완료 (프로덕션 등급, 매일 운용):

• SHFE 일일 선물 연구 — 데이터 수집, 214개 지표 카탈로그, Backtrader 실행, Optuna TPE 최적화(단일 및 다중 목표), 배포 준비 점수를 포함한 워크포워드 분석, KMeans 기반의 견고한 시도 선택.

• 에이전트 인터페이스 — 23개의 MCP 도구, 22개의 스킬, 32개의 오류 코드, 3개의 작업 템플릿.

미구현 (기능을 추진하고 싶다면 이슈를 열어주세요):

• SHFE 장중(intraday) 백테스트 — 데이터 파이프라인 준비 완료, 엔진 배관 작업 진행 중.

• MiniQMT를 통한 실거래 — 깔끔한 공개 릴리스 진행 중.

• 암호화폐 무기한 선물(CCXT 어댑터 스캐폴딩됨), CME 선물, 주식.

• Optuna 대안(그리드, 랜덤, 베이지안 예산 검색 없음), 분산 오케스트레이션, Python ≤ 3.10.

• 1.0 이전 — 공개 API는 마이너 버전 간에 변경될 수 있습니다. 주요 변경 사항은 CHANGELOG.md에 문서화되어 있습니다.

자체 데이터 사용

이미 원시 SHFE XLS 파일(shfe.com.cn에서 다운로드)이 있는 경우, akshare 대신 SHFEFileDayExtractor를 직접 실행하세요. 다른 형식(브로커 CSV, tushare, 사용자 정의 DB)의 경우, 다음 세 파일이 {workspace}/workspace/data/market_data/SHFE/{instrument}/ 아래에 있어야 합니다:

또한 {workspace}/data/SHFE/{instrument_code}/ 아래에 (SHORT 코드 사용, 예: aluminum이 아닌 al):

Echolon은 원시 OHLCV에서 main_contract.csv를 자동으로 파생하지 않습니다. 이는 사용자가 롤 규칙(거래량, 미결제 약정 또는 만기까지 남은 일수에 기반한 규칙)을 인코딩하여 입력해야 합니다. akshare를 통한 SHFE의 경우 echolon init이 이를 파생해주지만, 그렇지 않은 경우 직접 생성하여 배치해야 합니다.

프로젝트 정보

Apache 2.0 — LICENSE를 참조하세요. 상업적 용도를 포함하여 자유롭게 사용하십시오. 활발히 개발 중인 v0.1.2 베타 버전입니다. SHFE에서 Qorka를 운영하는 동일한 팀인 DolphinQuant가 구축 및 유지 관리합니다. 이슈 및 풀 리퀘스트는 github.com/dolphinquant/echolon에서 환영합니다.

@software{echolon,
  title = {Echolon: AI-native quantitative trading engine},
  author = {DolphinQuant},
  year = {2026},
  url = {https://github.com/dolphinquant/echolon},
}