cd ..

OpenAlice: 혼자서 월스트리트를 운영하는 파일 기반 AI 트레이딩 에이전트

# AI Research & Concepts # AI Agent # Claude Code # TypeScript
정석

OpenAlice: Your One-Person Wall Street

연구실, 퀀트 팀, 트레이딩 플로어, 리스크 관리 — 월스트리트 헤지 펀드에만 있던 것들. 이제 당신의 노트북에서 24/7 실행됩니다.

OpenAlice는 TraderAlice가 개발한 파일 기반 AI 트레이딩 에이전트 엔진입니다. 2026년 2월 18일 공개되어 단 24시간 만에 1,232+ 스타를 받으며 트레이딩 커뮤니티를 휩쓸었습니다. 데이터베이스도, 컨테이너도 없습니다. 그저 파일만으로 운영되는 “Your one-person Wall Street”입니다.

1. OpenAlice란 무엇인가?

대부분의 트레이딩 시스템은 복잡한 데이터베이스, 도커 컨테이너, 전용 인프라를 요구합니다. 하지만 OpenAlice는 다릅니다. 이 시스템은 **“파일만으로 모든 것을 제어”**할 수 있도록 설계되었습니다.

개발자가 “vibe coding”으로 프로그램을 작성하듯, 트레이더는 “vibe trading”으로 시장을 분석합니다. 직관적이고, 투명하고, 유연합니다.

2. 핵심 설계 철학: 3가지 원칙

📁 File-driven (파일 기반)

OpenAlice의 모든 것은 파일로 제어됩니다.

data/
├── config/              # JSON 구성 파일
├── brain/               # 에이전트 메모리/감정
├── sessions/            # JSONL 대화 이력
├── trading/             # 트레이딩 커밋 이력
├── news-collector/      # 뉴스 아카이브
└── event-log/           # 이벤트 로그

파일 구조만 봐도 시스템이 어떻게 동작하는지 이해할 수 있습니다. Git으로 버전 관리가 가능하며, 에이전트의 모든 결정이 투명하게 기록됩니다.

🧠 Reasoning-driven (추론 기반)

단순한 규칙 기반 트레이딩이 아닙니다. OpenAlice는 지속적 추론과 신호 믹싱을 통해 모든 트레이딩 결정을 내립니다. 시장 데이터, 뉴스, 기술적 지표, 감정 분석을 종합한 후, 논리적인 사고 과정을 거쳐 결정을 내립니다.

💻 OS-native (OS 네이티브)

OpenAlice는 운영체제와 직접 상호작용합니다.

별도의 격리된 환경이 아닌, 당신의 OS 위에서 자연스럽게 동작합니다.

3. 15가지 핵심 기능

1️⃣ Multi-provider AI

AI 백엔드를 런타임에 전환할 수 있습니다. 재시작 불필요.

data/config/ai-provider.json만 수정하면 즉시 전환됩니다.

{
  "activeProvider": "claude-code",
  "providers": {
    "claude-code": { ... },
    "vercel-ai-sdk": { ... },
    "agent-sdk": { ... }
  }
}

2️⃣ Unified Trading (통합 트레이딩)

CCXT와 Alpaca를 통합한 다중 계정 아키텍처를 제공합니다.

3️⃣ Git-like Trading Workflow

트레이딩도 Git처럼 관리합니다.

stage      # 주문 준비
commit     # 메시지와 함께 커밋 (8-char 해시)
push       # 거래소로 실행
tradingLog # 전체 이력 검토

모든 트레이딩 결정이 커밋으로 기록되며, 언제든지 되돌릴 수 있습니다.

4️⃣ Guard Pipeline (가드 파이프라인)

거래소로 주문이 전달되기 전에 안전 체크를 수행합니다.

이 가드들은 자산별로 구성할 수 있습니다.

5️⃣ Market Data (시장 데이터)

TypeScript 네이티브 OpenBB 엔진(opentypebb)을 내장하고 있습니다.

외부 사이드카가 불필요하며, TypeScript로 직접 작성되어 빠릅니다.

6️⃣ Equity Research (주식 리서치)

기업 분석을 위한 도구들을 제공합니다.

7️⃣ News Collector (뉴스 수집기)

백그라운드에서 RSS 피드를 수집합니다.

8️⃣ Cognitive State (인지 상태)

OpenAlice는 지속적인 “브레인”을 가집니다.

이 모든 것이 버전 관리됩니다.

9️⃣ Event Log (이벤트 로그)

append-only JSONL 이벤트 버스입니다.

🔟 Cron Scheduling (크론 스케줄링)

이벤트 기반 크론 시스템입니다.

1️⃣1️⃣ Evolution Mode (진화 모드)

2단계 권한 시스템을 제공합니다.

진화 모드에서는 에이전트가 자신의 소스 코드를 수정할 수 있습니다.

1️⃣2️⃣ Hot-reload (핫 리로드)

커넥터를 실시간으로 활성화/비활성화할 수 있습니다.

1️⃣3️⃣ Web UI

로컬 채팅 인터페이스를 제공합니다.

1️⃣4️⃣ Telegram Bot

모바일에서도 OpenAlice와 상호작용할 수 있습니다.

1️⃣5️⃣ MCP Server

외부 도구에 OpenAlice의 도구들을 노출합니다.

4. 아키텍처

OpenAlice는 모듈러 아키텍처로 설계되었습니다.

Providers (제공자)

AI 백엔드를 추상화합니다.

graph LR
    CC[Claude Code CLI]
    VS[Vercel AI SDK]
    AS[Agent SDK]
    PR[ProviderRouter]
    CC --> PR
    VS --> PR
    AS --> PR

ProviderRouter가 런타임에 ai-provider.json을 읽어 활성 백엔드를 선택합니다.

Core (코어)

시스템의 핵심 구성 요소들:

Extensions (확장)

도메인별 도구 패키지:

각 확장은 자체 도구, 상태, 영속성을 소유합니다.

Tasks (작업)

백그라운드 작업:

Interfaces (인터페이스)

외부 인터랙션:

5. 설치 및 실행

전제 조건

설치

git clone https://github.com/TraderAlice/OpenAlice.git
cd OpenAlice
pnpm install && pnpm build
pnpm dev

실행

pnpm dev        # 백엔드 시작 (포트 3002)
pnpm dev:ui     # 프론트엔드 개발 서버 (포트 5173)
pnpm build      # 프로덕션 빌드
pnpm test       # 테스트 실행

접속

http://localhost:3002

첫 실행에는 API 키나 구성이 필요 없습니다. 기본 설정은 Claude Code를 AI 백엔드로 사용합니다.

6. 구성

모든 구성은 data/config/에 JSON 파일로 저장됩니다 (Zod 검증). 누락된 파일은 합리적 기본값으로 폴백합니다.

주요 구성 파일

파일용도
engine.json트레이딩 페어, 틱 간격, 타임프레임
agent.json최대 에이전트 스텝, 진화 모드, Claude Code 도구 권한
ai-provider.json활성 AI 제공자 (런타임 전환 가능)
api-keys.jsonAI 제공자 API 키
platforms.json트레이딩 플랫폼 정의
accounts.json트레이딩 계정 자격 증명
crypto.jsonCCXT 거래소 구성
securities.jsonAlpaca 브로커 구성
connectors.jsonWeb/MCP 서버 포트
telegram.jsonTelegram 봇 자격 증명
tools.json도구 활성화/비활성화
openbb.json데이터 백엔드 구성
news-collector.jsonRSS 피드, 수집 간격
heartbeat.json하트비트 구성

페르소나와 하트비트

페르소나와 하트비트 프롬프트는 기본값 + 사용자 오버라이드 패턴을 따릅니다.

기본값 (git-tracked)사용자 오버라이드 (gitignored)
data/default/persona.default.mddata/brain/persona.md
data/default/heartbeat.default.mddata/brain/heartbeat.md

첫 실행 시 기본값이 자동으로 사용자 오버라이드 경로로 복사됩니다. 버전 관리를 건드리지 않고 사용자 파일을 편집하여 커스터마이즈할 수 있습니다.

7. Git-like Trading Workflow 상세

# 1. 주문 준비
tradingStage --symbol BTCUSDT --side buy --amount 0.1

# 2. 커밋 (8-char 해시 생성)
tradingCommit "BTC 가격 지지선 테스트"

# 3. 거래소로 실행
tradingPush

# 4. 이력 검토
tradingLog
tradingShow <hash>

모든 커밋은 8자 해시를 가지며, Git처럼 시간 여행이 가능합니다.

8. Evolution Mode (진화 모드)

OpenAlice의 가장 흥미로운 기능 중 하나입니다.

일반 모드 (기본)

진화 모드

# 진화 모드 활성화
# data/config/agent.json 수정
{
  "evolutionMode": true
}

주의: 진화 모드에서 에이전트가 스스로를 수정하다가 고장을 낼 수 있습니다. 반드시 본인의 저장소로 포크하여 작업하세요.

9. Pre-release 로드맵

OpenAlice는 pre-release 상태입니다. v1 안정화 전에 다음 항목들이 완료되어야 합니다.

🎯 Tool confirmation

민감한 도구 (주문 체결, 취소, 포지션 종료)는 실행 전 명시적 사용자 확인이 필요합니다. 신뢰할 수 있는 워크플로우를 위한 도구별 우회 메커니즘도 제공됩니다.

🎯 Trading-as-Git 안정화

stage → commit → push API 표면을 확정합니다. tradingStatus, tradingLog, tradingShow, tradingSync를 포함하여 안정적이고 버전 관리된 계약으로 만듭니다.

🎯 IBKR adapter

Interactive Brokers 통합 (Client Portal 또는 TWS API). CCXT와 Alpaca에 이어 세 번째 트레이딩 백엔드를 추가합니다.

🎯 Account snapshot & analytics

통합 트레이딩 계정 스냅샷, P&L 분해, 노출 분석, 과거 성과 추적을 제공합니다.

10. 실제 사용 시나리오

아침 7시: 시장 개장 전

OpenAlice가 자동으로 실행됩니다.

  1. 하트비트: 시장 상황을 검토
  2. 뉴스 수집: 밤새 수집된 뉴스 분석
  3. 감정 분석: 전반적인 시장 감정 파악

중요한 정보가 있으면 Telegram으로 알림이 옵니다.

아침 8시: 연구 시간

Web UI에서 OpenAlice와 대화합니다.

당신: "비트코인에 대해 어떻게 생각해?"
Alice: "최근 24시간 동안 5% 상승했습니다. 거래량도 평균보다 20% 높아요.
      주요 뉴스는 기관 투자자들의 매수 관심입니다.
      기술적 지표는 중립적입니다. 감정 분석은 긍정적입니다.
      요약하자면, 상승 추세가 유지될 가능성이 높지만,
      과매수 상태에 진입하고 있어 주의가 필요합니다."

오전 10시: 트레이딩 결정

AI의 추천을 검토합니다.

당신: "BTCUSDT를 0.1개 매수할 준비를 해줘."
Alice: "BTCUSDT 0.1개 매수를 스테이지했습니다.
      현재 가격: $67,500
      리스크: 최대 포지션의 10%
      가드: 쿨다운 30분 적용

      커밋할까요?"
당신: "네, 커밋해."
Alice: "커밋 완료. 해시: a1b2c3d4"

오후 2시: 포지션 관리

새로운 정보가 들어옵니다.

당신: "연준 의장이 발표를 해. 어떻게 대응해야 할까?"
Alice: "연준 의장의 발표 내용을 분석 중...
      금리 인하 시사 -> 비트코인 긍정적
      인플레이션 우려 -> 전체 시장 부정적

      추천: BTCUSDT 포지션을 절반 줄이고, USDT로 전환.
      리스크 헤지를 위해 골드도 검토해볼까요?"

11. 비용 최적화 전략

OpenAlice를 24/7 실행할 때 비용을 최적화하는 방법:

💰 AI 제공자 선택

💰 컴팩션

data/config/compaction.json에서 컨텍스트 윈도우 한계와 자동 요약 임계값을 설정할 수 있습니다.

{
  "contextWindowLimit": 200000,
  "autoCompactThreshold": 150000,
  "summaryPrompt": "대화 요약..."
}

💰 크론 스케줄링

필요할 때만 AI를 실행하도록 크론을 구성하세요.

{
  "jobs": [
    {
      "name": "market-check",
      "schedule": "0 8,12,16 * * *",
      "enabled": true
    }
  ]
}

12. 디렉토리 구조

src/
├── main.ts                    # 진입점
├── core/                      # 코어 (AgentCenter, ToolCenter, etc.)
├── ai-providers/              # AI 제공자 (Claude Code, Vercel, Agent SDK)
├── extension/                 # 확장 (trading, brain, analysis-kit)
├── openbb/                    # OpenBB 데이터 레이어
├── connectors/                # 커넥터 (Web UI, Telegram, MCP)
├── task/                      # 작업 (cron, heartbeat)
└── plugins/                   # MCP 서버, 스킬

data/
├── config/                    # JSON 구성
├── default/                   # 기본값 (persona, heartbeat)
├── sessions/                  # JSONL 대화 이력
├── brain/                     # 에이전트 메모리/감정
├── trading/                   # 트레이딩 커밋 이력
├── news-collector/            # 뉴스 아카이브
└── event-log/                 # 이벤트 로그

13. 보안 및 모범 사례

🔐 API 키 관리

data/config/api-keys.json에 API 키를 저장하세요. 이 파일은 .gitignore에 포함되어 있어 Git에 커밋되지 않습니다.

🔐 트레이딩 계정 자격 증명

data/config/accounts.json에 트레이딩 계정 자격 증명을 저장하세요. 이 파일도 .gitignore에 포함되어 있습니다.

🔐 진화 모드 주의사항

진화 모드를 활성화할 때는 반드시:

  1. 본인의 저장소로 포크
  2. 별도 브랜치에서 작업
  3. 정기적으로 백업
  4. 문제 발생 시 수동으로 이전 커밋으로 되돌리는 방법 숙지

🔐 가드 파이프라인

모든 트레이딩 작업에 가드를 적용하세요.

{
  "maxPositionSize": 1000,
  "cooldown": 1800,
  "symbolWhitelist": ["BTCUSDT", "ETHUSDT"]
}

14. 기술 스택

15. 커뮤니티 및 기여

기여 방법

  1. GitHub 저장소를 포크
  2. 기능 브랜치 생성
  3. 변경 사항 커밋
  4. 브랜치 푸시
  5. 풀 리퀘스트 생성

버그 보고

GitHub Issues를 사용하여 버그를 보고하세요. 버그 리포트에 다음을 포함해주세요:

마치며: 개인 투자자의 월스트리트

OpenAlice Trading Interface

OpenAlice는 단순한 트레이딩 봇이 아닙니다. 이것은 **“개인 투자자를 위한 월스트리트”**입니다.

연구실, 퀀트 팀, 트레이딩 플로어, 리스크 관리 — 헤지 펀드에만 있던 것들이 이제 당신의 노트북에서 24/7 실행됩니다.

파일 기반의 투명함, 추론 기반의 지능, OS 네이티브의 유연함 — 이 세 가지가 결합된 OpenAlice는 트레이딩의 새로운 패러다임을 제시합니다.

“Your one-person Wall Street” — 이제 당신도 월스트리트입니다.

🔗 관련 정보

📚 추가 자료

# AI Research & Concepts # AI Agent # Claude Code # TypeScript
Compartir
이전
cship: Claude Code를 위한 세련된 상태줄
다음
Lightpanda: AI와 자동화를 위해 처음부터 다시 쓴 헤드리스 브라우저