Alpha-Dojo/DojoAgents

DojoAgents – AI 기반 개인 투자 보조자

DojoAgents는 개인 투자자가 자신의 컴퓨터에서 포트폴리오 인식 AI 에이전트를 실행할 수 있는 오픈소스 프레임워크입니다. 핵심은 대규모 언어모델(OpenAI, Gemini, Anthropic 등)과 금융 전용 도구(시장 데이터 수집기, 뉴스 스크래퍼, 기술 지표 계산기, Python 사전 등)를 조율하는 에이전트 루프입니다. 에이전트는 여러 시장(미국, 홍콩, A주)을 분석하고 사용자의 보유 자산을 추적하며, 일일 시장 개요, 뉴스 영향 평가, 포트폴리오 스크린샷 기반 리스크 진단과 같은 다단계 분석을 수행할 수 있습니다.

주요 구성 요소

구성 요소	기능
에이전트 루프 엔진	LLM을 실행하고 어떤 도구를 호출할지 결정하며, 컨텍스트를 압축하고 "금융 환각"을 방지하기 위한 가드레일을 강제합니다.
실행 사전	실시간 계산(예: 기술 지표) 및 웹 스크래핑을 위한 격리된 Python 환경입니다.
메모리 & SKILLS	성공적인 다단계 워크플로우를 재사용 가능한 "스킬"로 저장하여 나중에 호출할 수 있습니다.
Cron & 게이트웨이	자동 인사이트를 스케줄링하고 Slack, Telegram, Discord, WeChat 등 채팅 플랫폼으로 전송합니다.
FastAPI 백엔드 + React SPA 대시보드	사용자가 포트폴리오 메트릭, 시장 히트맵, 섹터 트리 등을 시각화하고 챗으로 에이전트와 상호작용할 수 있는 웹 UI를 제공합니다.

할 수 있는 일들

일일 시장 개요 – "오늘 주목할 만한 것은 무엇인가요?"라고 묻고, 에이전트는 다중 시장의 움직임, 섹터 회전, 가격/거래량 변화를 수집하며 각 도구 호출 내역도 표시합니다.
뉴스 영향 분석 – 뉴스 제목(예: 메타의 AI 인프라 확장)을 입력하면 영향을 받을 수 있는 미국 및 A주 주식을 데이터와 함께 분석해 줍니다.
스크린샷 기반 포트폴리오 진단 – 보유 목록 이미지를 업로드하면 멀티모달 모델이 티커를 추출하고 그룹화하며, 과도한 집중도나 방어 자산 누락을 경고합니다.
시뮬레이션 리밸런싱 – 진단 후 에이전트는 거래 제안을 하고 "만약에" 포트폴리오를 생성하며, 대시보드에서 성과를 추적합니다.

빠른 시작 (README에서)

# 1. uv(권장)로 가상 환경 생성 및 패키지 설치
uv venv && source .venv/bin/activate
uv pip install dojoagents   # 공개된 웨일을 다운로드

# 2. (선택 사항) 소스에서 웹 UI 빌드
cd dojoagents/dashboard/web
npm install && npm run build

# 3. 서버 실행
dojoagents dashboard --host 127.0.0.1 --port 8765

브라우저에서 표시된 URL을 열고 설정 패널에서 LLM API 키를 설정합니다(OpenAI, Anthropic, Gemini, Zhipu GLM, DeepSeek, 또는 Ollama 같은 로컬 엔드포인트 지원). UI는 FastAPI 백엔드와 OpenAI 호환 챗 엔드포인트 및 Server-Sent Events를 통해 실시간 차트 업데이트를 받는 React SPA입니다.

확장성

사용자 정의 하네스 – 프레임워크는 금융 하네스(프롬프트, 도구, 정책)와 일반 런타임을 분리합니다. 개발자는 자체 하네스 YAML 또는 Python 팩토리를 제공해 다른 분야에도 적용할 수 있습니다.
플러그인 / 스킬 – 새로운 데이터 소스 추가, Python 기반 지표 함수 작성, 에이전트가 자동으로 호출할 수 있는 재사용 가능한 다단계 분석 스크립트 생성 가능.
오미채널 게이트웨이 – 에이전트를 Slack, Discord, WeChat, Feishu, 이메일 등에 연결해 스케줄된 브리핑을 전송할 수 있습니다.

라이선스 및 면책 조항

DojoAgents는 Apache 2.0 라이선스로 배포됩니다. 저자들은 이 소프트웨어는 교육 및 연구 목적에만 사용되며, 투자 조언이 아니며, 모든 거래 결정의 위험은 사용자 본인이 부담해야 한다고 강조합니다.

결론: DojoAgents는 LLM 추론, 도구 조율, 정교한 금융 대시보드를 결합한 진정한 엔드투엔드 AI 에이전트 플랫폼입니다. 소규모 투자자에게 기관 수준의 분석 보조자를 제공합니다. 완전히 오픈소스이며 확장 가능하며, 선호하는 모든 LLM 제공업체와 함께 로컬에서 실행할 수 있습니다.