2026년 MiroFish 설치: 원격 M4 Mac 군집 지능 예측 엔진

MiroFish는 AGPL-3.0 군집 지능 엔진으로, 뉴스·정책·시장 시그널 등 시드 문서에서 GraphRAG 디지털 세계를 만들고 OASIS(CAMEL-AI)로 멀티 에이전트 사회 시뮬레이션을 실행합니다. Vue UI는 포트 3000, API는 포트 5001입니다. KuzCloud M4에서는 Docker Compose가 가장 빠르고, 수백 에이전트는 16GB RAM, 1K+ 경량 페르소나는 24GB를 권장합니다.

작업 전 요금 페이지에서 리전을 고정하고 헬프 센터 SSH 절차를 Runbook에 붙이세요. 아시아 API에는 서울 노드, OpenAI 네이티브 키에는 미국 동부를 검토하세요.

MiroFish란

다섯 단계 예측 파이프라인: 그래프 구축 → 환경 설정 → 시뮬레이션(OASIS) → ReportAgent 리포트 → Deep Interaction.

TradingAgents는 거래 위원회, MiroFish는 사회 스웜입니다. 많은 퀀트 팀이 실행은 TradingAgents, 자본 투입 전 시나리오 리허설은 MiroFish로 합니다.

하드웨어와 RAM

워크로드	에이전트	SKU	비고
데모	50~200	M4 16GB	Docker+UI
팀 실험	500~2,000	M4 24GB	병렬 OASIS, 스왑 주의
스트레스	5,000+	24GB+API	분산 호스트 필요

16GB vs 24GB, 버스트 vs 월간 참고.

KuzCloud MiroFish 설치 5단계

1단계 — 노드·SSH

서울 노드·홍콩(아시아 API) 또는 미국 동부(OpenAI). ssh -i key.pem user@node-ip, brew install colima docker && colima start.

2단계 — 클론·.env

git clone https://github.com/666ghj/MiroFish.git → cp .env.example .env

3단계 — Docker Compose

docker compose up -d — Vue 3000, API 5001. 터널: ssh -L 3000:localhost:3000 -L 5001:localhost:5001 ...

4단계 — 예측 실행

시드 업로드 → 목표 기술 → 리포트. 16GB 첫 풀런 30~90분 흔함.

5단계 — 저장·해제

~/mirofish-runs/에 저장, docker compose down, 버스트면 노드 해제.

네트워크·API·컴플라이언스

• LLM 비용 우세 — 1K 에이전트 실험 $50~200 가능
• AGPL-3.0 SaaS 시 소스 공유 의무 확인
• 시드는 렌탈 Mac 디스크 — 리전 매트릭스

문제 해결

증상	원인	조치
0% 정지	.env 키	쿼터·모델명
OOM	16GB	24GB 또는 에이전트 축소
3000 거부	compose/터널	docker ps, -L 재실행
느린 API	리전	서울 노드 vs 미국 동부

FAQ

Docker 없이? 가능하나 Docker 권장.

GPU? 불필요(API/CPU).

OpenClaw? 코딩 에이전트 vs 사회 시뮬.

최소 렌탈? 3~7일 버스트.

TradingAgents 병행? 24GB, 동시 무거운 심 금지.