MiroFish: AI 에이전트 수천 개로 미래 예측하는 오픈소스 시뮬레이션 엔진
AI 에이전트 수천 개가 가상 세계에서 여론·시장·스토리를 시뮬레이션하는 오픈소스 엔진 MiroFish. GitHub 스타 27,000개 돌파. 마케팅 반응 예측부터 정책 시뮬레이션까지 무료로 설치해 바로 활용할 수 있습니다.
"신제품을 출시하면 사람들이 어떻게 반응할까?" "이 정책을 발표하면 여론이 어떻게 움직일까?" — 현실에서는 한 번 실행하면 되돌릴 수 없는 결정들입니다. MiroFish는 이런 질문에 AI 에이전트 시뮬레이션으로 가상 세계를 만들어서 미리 답을 보여주는 오픈소스 도구입니다. GitHub에서 하루 만에 스타 약 3,000개를 받으며 전체 트렌딩 상위에 올랐고, 누적 스타는 27,000개를 넘었습니다.
MiroFish AI 시뮬레이션이란? 가상 세계에서 미리 테스트하는 원리
MiroFish의 핵심 아이디어는 간단합니다. AI 에이전트(Multi-Agent) 수천 개를 만들어서 가상 세계에 풀어놓고, 그들이 어떻게 행동하는지 관찰하는 것입니다.
예를 들어볼게요. 여러분이 새로운 마케팅 캠페인을 기획하고 있다고 합니다. MiroFish에 캠페인 초안과 관련 시장 데이터를 넣으면, AI가 다양한 성격·나이·관심사를 가진 가상 소비자 수천 명을 만들어요. 이 가상 소비자들은 각자의 성격, 기억, 행동 패턴을 갖고 있어서, 캠페인에 대해 서로 다르게 반응하고 의견을 나눕니다.
결과적으로 "이 캠페인을 실행하면 20대는 긍정적이지만 40대에서 반발이 있을 수 있다"같은 예측 보고서를 받아볼 수 있는 것입니다.
AI 에이전트 시뮬레이션 활용 사례: 여론, 스토리, 금융 예측
🏢 여론 시뮬레이션 — 프로젝트 데모에서는 대학교 관련 사건을 시뮬레이션했습니다. 뉴스 기사를 씨앗 데이터로 넣으면 AI 에이전트들이 SNS 사용자처럼 반응하고, 여론이 어떻게 퍼지고 변하는지 시간 흐름에 따라 보여줍니다.
📖 스토리 예측 — 중국 고전소설 《홍루몽》의 미완성 결말을 예측하는 데모도 있습니다. 소설의 앞부분 80장을 넣으면 AI 캐릭터들이 등장인물의 성격대로 행동하면서 뒷이야기를 만들어냅니다.
📊 금융·정책 분석 — 시장 데이터나 정책 초안을 넣어서 경제 변화나 정책 효과를 미리 시뮬레이션하는 기능도 개발 중입니다. 아직 데모 단계이지만 로드맵에 포함돼 있습니다.
MiroFish 작동 원리: GraphRAG 기반 멀티에이전트 시스템
MiroFish는 GraphRAG(지식 그래프 기반 검색 기술, 데이터 속 인물·사건·관계를 그물처럼 연결하는 방식)를 사용합니다. 작동 과정을 쉽게 설명하면 이렇습니다:
1 씨앗 데이터 입력 — 뉴스, 보고서, 소설 등 원하는 자료를 넣습니다
2 관계망 구축 — AI가 자동으로 인물, 조직, 사건 사이의 관계를 파악합니다
3 AI 에이전트 생성 — 각각 고유한 성격과 기억을 가진 가상 캐릭터를 수천 개 만듭니다
4 시뮬레이션 실행 — 가상 세계에서 에이전트들이 상호작용하며 상황이 전개됩니다
5 예측 보고서 생성 — AI가 시뮬레이션 결과를 분석해서 보고서로 정리해줍니다
특히 재미있는 건 "신의 시점(God View)" 기능입니다. 시뮬레이션 도중에 새로운 변수를 넣을 수 있습니다. 예를 들어 "경쟁사가 가격을 50% 인하했다"는 변수를 추가하면 AI 에이전트들이 즉시 반응하면서 시나리오가 달라집니다. 현실에서 할 수 없는 "what if" 실험을 무한히 반복할 수 있는 것입니다.
AI 시뮬레이션 도구, 누가 활용하면 좋을까?
마케터라면 — 캠페인 출시 전에 타겟 고객층의 반응을 미리 시뮬레이션해볼 수 있습니다. "이 광고 카피가 MZ세대에게 먹힐까?"를 가상으로 테스트하는 것입니다.
기획자·전략가라면 — 신규 정책이나 서비스 변경의 파급효과를 사전에 예측할 수 있습니다. 실제로 실행하기 전에 가상 세계에서 먼저 돌려보는 셈입니다.
콘텐츠 크리에이터라면 — 소설이나 시나리오의 캐릭터 반응을 시뮬레이션해서 더 자연스러운 스토리라인을 만들 수 있습니다.
AI 도구 활용법이 처음이라면 AI 기초 학습 가이드부터 시작해보세요.
MiroFish 설치 방법: Docker로 5분 만에 시작하기
오픈소스(AGPL-3.0 라이선스)로 공개돼 있어서 누구나 무료로 설치할 수 있습니다. 다만 AI API 키가 필요합니다.
필요한 것:
- Node.js 18 이상, Python 3.11~3.12
- LLM API 키 (OpenAI 형식 지원 — 알리바바 Qwen-Plus 모델 권장)
- Zep Cloud 계정 (AI 에이전트의 기억 관리용)
# 소스코드 설치
git clone https://github.com/666ghj/MiroFish.git
cd MiroFish
cp .env.example .env
# .env 파일에 API 키 입력 후
npm run setup:all
npm run dev
# Docker로 설치 (더 간단)
docker compose up -d설치 후 localhost:3000에서 웹 인터페이스를 열 수 있습니다. Docker를 쓰면 더 간단하게 시작할 수 있습니다. 개발 환경 세팅이 어렵다면 무료 학습 가이드에서 기초부터 단계별로 배워보세요.
MiroFish가 GitHub 트렌딩 1위에 오른 이유
AI 에이전트를 활용한 시뮬레이션은 학술 연구에서는 이미 활발하지만, 일반인이 설치해서 바로 써볼 수 있는 오픈소스 멀티에이전트 도구는 드물었습니다. MiroFish가 하루 만에 깃허브 스타 약 3,000개를 받은 건 이 니즈가 그만큼 컸다는 뜻입니다.
물론 한계도 있습니다. 시뮬레이션 결과가 실제 미래를 정확히 맞추는 건 아닙니다. AI 에이전트의 행동은 학습 데이터에 기반하기 때문에, 예상치 못한 돌발 변수는 반영하기 어렵습니다. 하지만 "여러 시나리오를 빠르게 탐색한다"는 점에서, 의사결정의 보조 도구로는 충분히 가치가 있습니다.
샨다 그룹(Shanda Group)이 후원하고 있고, 금융 예측과 시사 뉴스 분석 기능을 계속 확장 중입니다. Python 57.8%와 Vue 41.1%로 구성돼 있어서 웹 기반 인터페이스로 바로 사용할 수 있는 구조입니다.
AI 업무 자동화에 대해 더 알고 싶다면 무료 학습 가이드를 확인해보세요.