README_KO.md

QuantDinger

프라이빗 AI 퀀트 운영체제

차트 연구, AI 시장 분석, Python 인디케이터·전략, 백테스트, 라이브 실행을 자체 서버와 자체 API 키로 한 스택에서 운영합니다.

셀프호스트 퀀트 플랫폼: 아이디어와 AI 보조 코딩부터 페이퍼 워크플로, 거래소 연동 라이브까지. 선택적 멀티유저·과금 프리미티브.

English · 简体中文 · 日本語 · 한국어 · ไทย · Tiếng Việt · العربية

SaaS  ·  데모 영상  ·  공식 사이트  ·  AWS Marketplace

     

---

목차

빠른 시작 · 관련 저장소 · MCP / Agent · 개요 · 기능 · 스크린샷 · 아키텍처 · 설치 · 문서 · FAQ · 라이선스

---

QuantDinger는 셀프호스트·로컬 우선 퀀트 플랫폼입니다. AI 보조 리서치, Python 네이티브 전략, 백테스트, 라이브 거래(암호화폐, IBKR 미국 주식, MT5 FX)를 하나의 제품으로 묶습니다.

_{데이터 소스에서 인디케이터·시그널·전략·백테스트·AI 분석으로 이어지는 폐쇄 루프.}

빠른 시작

필요: Docker + Compose, Git. Node.js 불필요(frontend/dist에 빌드된 UI 포함).

macOS / Linux

git clone https://github.com/brokermr810/QuantDinger.git && cd QuantDinger && cp backend_api_python/env.example backend_api_python/.env && chmod +x scripts/generate-secret-key.sh && ./scripts/generate-secret-key.sh && docker-compose up -d --build

docker-compose가 없으면 docker compose를 사용하세요.

Windows (PowerShell)

Docker Desktop을 켠 뒤 PowerShell에서:

git clone https://github.com/brokermr810/QuantDinger.git
Set-Location QuantDinger
Copy-Item backend_api_python\env.example -Destination backend_api_python\.env
$key = & python -c "import secrets; print(secrets.token_hex(32))" 2>$null
if (-not $key) { $key = & py -c "import secrets; print(secrets.token_hex(32))" 2>$null }
if (-not $key) { Write-Error "Python 3를 PATH에 추가하세요." }
(Get-Content backend_api_python\.env) -replace '^SECRET_KEY=.*$', "SECRET_KEY=$key" | Set-Content backend_api_python\.env -Encoding utf8
docker-compose up -d --build

Windows (Git Bash)

Git for Windows Bash에서는 위 macOS/Linux 한 줄 명령을 그대로 사용할 수 있습니다.

---

브라우저에서 http://localhost:8888 → quantdinger / 123456 로그인 후 관리자 비밀번호를 즉시 변경하세요. 자세한 내용은 설치 및 첫 실행을 참고하세요.

관련 저장소

저장소	내용
QuantDinger (본 저장소)	백엔드, Compose, 문서, 프리빌드 Web
QuantDinger-Vue	Web 프론트 소스(Vue) — npm run build로 frontend/dist 교체
QuantDinger-Mobile	모바일 클라이언트(오픈소스)

MCP / Agent 게이트웨이

Cursor / Claude Code / Codex 등을 위한 Model Context Protocol(MCP) 및 Agent Gateway(/api/agent/v1). 상세는 영어 문서가 기준입니다:

• AGENT_QUICKSTART.md · AI_INTEGRATION_DESIGN.md · agent-openapi.json
• MCP 서버: ../mcp_server/README.md · PyPI quantdinger-mcp

보안: 모든 Agent 호출은 감사 로그에 기록됩니다. 거래(T) 토큰은 기본 페이퍼만; 라이브는 서버 AGENT_LIVE_TRADING_ENABLED=true와 토큰 paper_only=false가 모두 필요합니다.

제품 개요

셀프호스트 가능한 AI + Python 전략 + 백테스트 + 라이브 통합 환경입니다. 자격 증명은 PostgreSQL과 **.env**로 관리합니다. 암호화폐 거래소, IBKR, MT5, LLM은 환경 변수로 연결합니다.

비주얼 투어

▶ 데모 영상 보기
인디케이터 IDE·차트·백테스트	AI 자산 분석
트레이딩 봇	라이브 전략·성과

기능 하이라이트

• 리서치 & AI — 멀티 LLM 분석, 관심목록, 기록; NL→코드; Polymarket 리서치 플로; Agent / MCP 연동.
• 구축 — IndicatorStrategy와 ScriptStrategy(on_bar); 프로 K라인 UI.
• 검증 — 서버 사이드 백테스트, 에퀴티 커브.
• 운영 — 암호화폐 실행, 퀵 트레이드, IBKR / MT5; Telegram, 이메일, Discord, Webhook 등.
• 플랫폼 — Docker Compose, Postgres, Redis, OAuth, 멀티유저, 크레딧·멤버십·USDT 과금 스위치.

아키텍처

flowchart LR
    U[트레이더 / 운영자]

    subgraph FE[프론트]
        WEB[Vue]
        NG[Nginx]
    end

    subgraph BE[백엔드]
        API[Flask API]
        AI[AI 서비스]
        STRAT[전략·백테스트]
        EXEC[실행]
    end

    subgraph DATA[데이터]
        PG[(PostgreSQL)]
        REDIS[(Redis)]
    end

    subgraph EXT[외부]
        LLM[LLM]
        EXCH[거래소]
        BROKER[IBKR / MT5]
    end

    U --> WEB --> NG --> API
    API --> AI
    API --> STRAT
    API --> EXEC
    AI --> PG
    STRAT --> PG
    EXEC --> PG
    API --> REDIS
    AI --> LLM
    EXEC --> EXCH
    EXEC --> BROKER

Loading

설치 및 첫 실행

1. 클론 후 cp backend_api_python/env.example backend_api_python/.env
2. SECRET_KEY 필수 설정(플레이스홀더면 백엔드가 시작되지 않음). Linux/macOS: ./scripts/generate-secret-key.sh
3. docker-compose up -d --build
4. Web: http://localhost:8888 · API 헬스: http://localhost:5000/api/health
5. 프로덕션 전 기본 관리자 비밀번호 변경. backend_api_python/.env의 **FRONTEND_URL**을 실제 URL에 맞추세요.

AI 기능은 env.example의 AI / LLM 섹션을 .env에 반영한 뒤 backend를 재시작하세요. 긴 체크리스트는 영어 README 또는 简体中文를 참고하세요.

문서 목록

문서	설명
English README	전체(영어)
简体中文	전체(중국어 간체)
CHANGELOG	변경 이력
Agent 빠른 시작(영어)	Agent Gateway / curl 예제
전략 가이드(영어)	인디케이터·스크립트 전략 개발

기타: multi-user-setup.md · IBKR · MT5 — 상세는 영어 문서가 중심입니다.

자주 묻는 질문

정말 셀프호스트 가능한가요? 네. Docker Compose로 자체 인프라에 배포합니다.

암호화폐만인가요? 아니요. IBKR(미국 주식), MT5(FX), Polymarket 리서치도 지원합니다.

Python으로 전략을 쓸 수 있나요? 네. IndicatorStrategy와 ScriptStrategy를 지원합니다.

상업적 이용? 백엔드는 Apache 2.0. QuantDinger-Vue 프론트는 별도 소스 가용 라이선스—상업 이용 전 조항을 확인하세요. 모바일은 QuantDinger-Mobile 라이선스를 따릅니다.

모바일은? QuantDinger-Mobile을 참고하세요.

거래소 추천 링크(참고)

거래소	링크
Binance	가입
OKX	가입
Bybit	가입

라이선스

• 백엔드: Apache License 2.0 (../LICENSE)
• 동봉 Web UI: 프리빌드 배포. 소스는 QuantDinger-Vue(별도 라이선스)
• 상표: ../TRADEMARKS.md

면책

QuantDinger는 합법적인 연구·교육·규정 준수 거래용입니다. 투자 조언이 아닙니다. 이용은 본인 책임입니다.

커뮤니티

• Telegram · Discord · Issues
• Email: support@quantdinger.com

Star 히스토리

감사의 말

Flask, Pandas, CCXT, Vue.js, KLineCharts, ECharts 등 오픈소스 커뮤니티에 감사드립니다.

_{도움이 되었다면 GitHub Star 부탁드립니다.}