MiroFish의 개요
Shanda Group의 인큐베이팅을 받은 MiroFish는 뉴스 기사, 정책 초안, 소설 같은 시드 자료에서 지식 그래프를 만들고, 그 안의 사람과 집단에 대한 에이전트 페르소나를 생성한 뒤 Twitter형과 Reddit형 모의 플랫폼에서 동시에 실행합니다. 이어서 ReportAgent가 모의 세계를 읽고 예측 보고서를 작성하며, 실행 후 어떤 에이전트와도 대화하거나 실행 중에 새 변수를 주입할 수 있습니다.
시뮬레이션 자체는 README가 밝히듯 CAMEL-AI의 OASIS입니다. MiroFish는 파이프라인, Vue 웹 앱, 에이전트 기억을 위한 Zep Cloud, 보고서 단계를 더합니다. OpenAI 호환 LLM 엔드포인트(README는 Alibaba의 qwen-plus를 권장)와 Zep Cloud 키가 필요하며, 소스 코드나 Docker Compose로 실행합니다.
저장소는 2025년 11월 26일에 만들어졌고 AGPL-3.0이며, GitHub 스타는 약 83,700개, 포크는 12,700개입니다. 마지막 태그 릴리스는 v0.1.2(2026년 3월 7일)이며, 2026년 7월에 안정성 수정이 한꺼번에 들어갔습니다.
MiroFish, 쓸 만한 가치가 있습니까?
MiroFish는 잘 포장된 시나리오 시뮬레이터이지 예측 도구가 아니며, 이 구분이 토큰을 쓸 가치가 있는지를 가릅니다. 정책 초안이나 뉴스 기사를 올리고 알고 싶은 것을 적으면, 글 속 사람과 집단의 페르소나를 만들어 두 개의 모의 플랫폼에서 게시하고, 답하고, 팔로하고, 다투게 한 뒤 결과를 ReportAgent에 넘깁니다. 결과물은 예측처럼 읽힙니다. 이번 확인 시점에 프로젝트는 정확도 벤치마크나 백테스트를 공개하지 않았고, README의 금융과 정치 사례는 여전히 공개 예정으로 표시돼 있습니다.
어려운 부분은 대부분 빌려 온 것입니다. 에이전트 사회는 CAMEL-AI의 OASIS로, 최대 100만 에이전트와 23가지 행동을 위해 만들어진 동료 심사를 거친 시뮬레이터입니다. MiroFish 설정은 Twitter형 플랫폼에서 6가지, Reddit형에서 13가지 행동을 노출합니다. MiroFish가 더하는 것은 접착제입니다. 시드 자료를 그래프로 추출하고, 페르소나를 생성하고, 웹 앱과 보고서 에이전트를 제공하며, 실행 후 에이전트를 인터뷰할 수 있게 합니다. 이 접착제가 약 83,700개 스타의 이유이고, 시뮬레이션만 필요한 팀이라면 OASIS로 바로 가도 되는 이유이기도 합니다.
계획해야 할 것은 비용입니다. 에이전트의 모든 행동이 LLM 호출이므로 지출은 에이전트 수와 라운드 수의 곱으로 늘어납니다. README는 소모가 크다고 경고하며 40라운드 미만으로 시작하라고 권하고, 기본값은 10입니다. 실행당 토큰 수는 공개되지 않았습니다. 기억은 Zep Cloud를 거치며, 무료 등급은 월 10,000크레딧에 요청 한도가 변동합니다. 그 이상은 Flex가 월 $125에 50,000크레딧입니다.
주의할 점: 진지한 환경에서는 호스팅 의존성과 라이선스가 발목을 잡습니다. 업로드한 문서와 각 페르소나의 기억이 네트워크 밖의 LLM 제공업체와 Zep으로 나가므로, Neo4j와 Ollama 기반 포크인 MiroFish-Offline으로 바꾸지 않는 한 기밀 자료에는 쓸 수 없습니다. AGPL-3.0이므로 수정한 코드로 만든 호스팅 제품은 사용자에게 소스 코드를 제공해야 합니다. 문서화된 설정에서 웹 앱에는 로그인이 없고 Flask 비밀 키는 고정된 기본값으로 대체되므로 localhost에만 두어야 합니다. 릴리스는 3월 v0.1.2에서 멈췄고, 열린 이슈와 풀 리퀘스트는 약 228개입니다. 또한 LLM 에이전트는 사람보 다 군중을 더 따르는 경향이 있어 쏠림 효과가 과장됩니다.
결론: MiroFish 실행은 탁상 워게임처럼 다뤄야 합니다. 미처 생각하지 못한 반응과 논점을 끌어내는 데는 좋지만, 실제로 무슨 일이 일어날지에 대한 증거로는 약합니다. 적어도 판단을 백테스트할 수 있는 TradingAgents와 비교하면 더 많은 믿음을 요구합니다.
제 역할을 하는 곳
중견 소비재 브랜드의 커뮤니케이션 책임자
제품 리콜 성명이 발표 전에 소셜 미디어에서 어떻게 받아들여질지 확인하기
성명 초안과 최근 보도를 올리고 10라운드 시뮬레이션을 돌린 뒤 가장 화난 페르소나에게 이유를 묻습니다. 비용은 LLM 토큰과 Zep 무료 등급이며, 얻는 것은 감성 예측이 아니라 대응해야 할 반론 목록입니다.
계산사회과학 대학원생
OASIS를 직접 연결하지 않고 빠르게 양극화 실험하기
정책 문서를 MiroFish에 넣고 실행 중에 신의 시점에서 변수 하나를 바꾼 뒤 두 실행의 보고서를 비교합니다. 발표할 만한 연구라면 OASIS로 바로 옮겨 에이전트 프롬프트를 직접 통제합니다.
소설가나 게임 시나리오 작가
등장인물들이 플롯 반전에 어떻게 반응할지 탐색하기
README의 데모는 『홍루몽』 앞 80회를 바탕으로 결말을 이어 씁니다. 원고를 올리고 반전을 주입한 뒤 등장인물과 대화합니다. 원고가 길수록 그래프 추출 호출이 늘어납니다.
도입 전 확인할 점
- 설정
- .env.example을 .env로 복사해 LLM_API_KEY, LLM_BASE_URL, LLM_MODEL_NAME, ZEP_API_KEY를 넣고 npm run setup:all과 npm run dev를 실행합니다(Node 18+, Python 3.11~3.12, uv). 또는 docker compose up -d. 앱은 포트 3000과 5001에서 동작합니다.
- 연동
- OpenAI 호환 LLM API라면 무엇이든 쓸 수 있고, 더 빠른 두 번째 모델을 선택적으로 둘 수 있습니다. 그래프 기억은 Zep Cloud, 시뮬레이션은 OASIS와 CAMEL. 업로드는 50MB까지의 PDF, Markdown, 텍스트 파일을 받습니다.
- 데이터와 개인정보
- 앱은 자체 호스팅이지만 시드 문서, 페르소나 기억, 프롬프트는 LLM 제공업체와 Zep Cloud로 갑니다. 시뮬레이션 데이터는 backend/uploads에 저장됩니다. AGPL-3.0. 포크 MiroFish-Offline은 Zep과 클라우드 LLM을 Neo4j와 Ollama로 바꿉니다.
- 대규모 사용 시 비용
- 유료 에디션은 없습니다. LLM 비용은 에 이전트 수와 라운드 수의 곱으로 늘고 실행당 토큰 수는 공개되지 않았습니다. Zep 무료 등급은 월 10,000크레딧, Flex는 $125/월에 50,000크레딧입니다.
- 제한
- 공개된 정확도 벤치마크 없음, 열린 이슈와 풀 리퀘스트 약 228개, 2026년 3월 v0.1.2 이후 태그 릴리스 없음, LLM 에이전트는 사람보다 쏠림이 심함, 내장 인증 없음.
좋은 점
- 코드 없이 웹 UI로 문서에서 시뮬레이션까지 이어지는 파이프라인
- 동료 심사를 거친 소셜 시뮬레이터 OASIS 기반
- 실행 후 개별 에이전트와 ReportAgent 인터뷰 가능
- OpenAI 호환 LLM 엔드포인트면 무엇이든 사용 가능, 영어와 중국어 UI
아쉬운 점
- 공개된 정확도 벤치마크나 백테스트가 없음
- 토큰 지출이 에이전트 수와 라운드 수의 곱으로 증가하며 실행당 수치 없음
- Zep Cloud가 필요해 문서와 기억이 네트워크 밖으로 나감
- 웹 앱에 로그인 없음, 마지막 릴리스 2026년 3월
추천 대상
초안에 대한 대중의 반응을 미리 시험해 보려는 홍보, 정책, 연구 팀 가운데 결과를 예측이 아니라 시나리오로 읽을 사람들.
MiroFish 대안
MiroFish: 자주 묻는 질문
- MiroFish, 쓸 만한 가치가 있습니까?
- MiroFish는 LLM 페르소나 군중이 문서에 어떻게 반응하는지 지켜보는 가장 쉬운 방법이지만, 그 예측이 꼼꼼한 분석가보다 낫다는 근거는 아직 없습니다. 평점은 5점 만점에 3.6점입니다.
- MiroFish의 가격은 얼마입니까?
- 무료 오픈 소스(AGPL-3.0)입니다. LLM 토큰 비용과, 월 10,000크레딧 무료 한도를 넘는 Zep Cloud 메모리 비용을 냅니다. Zep Flex는 $125/월입니다.
- MiroFish의 단점은 무엇입니까?
- 공개된 정확도 벤치마크나 백테스트가 없음; 토큰 지출이 에이전트 수와 라운드 수의 곱으로 증가하며 실행당 수치 없음; Zep Cloud가 필요해 문서와 기억이 네트워크 밖으로 나감; 웹 앱에 로그인 없음, 마지막 릴리스 2026년 3월.
- MiroFish에 적합한 사람은 누구입니까?
- 초안에 대한 대중의 반응을 미리 시험해 보려는 홍보, 정책, 연구 팀 가운데 결과를 예측이 아니라 시나리오로 읽을 사람들.
- 팀이나 프로덕션 환경에서 MiroFish의 비용은 얼마입니까?
- 유료 에디션은 없습니다. LLM 비용은 에이전트 수와 라운드 수의 곱으로 늘고 실행당 토큰 수는 공개되지 않았습니다. Zep 무료 등급은 월 10,000크레딧, Flex는 $125/월에 50,000크레딧입니다.
- MiroFish에 회사 데이터를 맡겨도 안전합니까?
- 앱은 자체 호스팅이지만 시드 문서, 페르소나 기억, 프롬프트는 LLM 제공업체와 Zep Cloud로 갑니다. 시뮬레이션 데이터는 backend/uploads에 저장됩니다. AGPL-3.0. 포크 MiroFish-Offline 은 Zep과 클라우드 LLM을 Neo4j와 Ollama로 바꿉니다.
- MiroFish의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 TradingAgents 및 DeerFlow입니다.
답변 확인일: 2026년 11월 3일.