MiroShark

문서나 뉴스 시드를 넣으면 Neo4j 기반 지식 그래프와 다수의 페르소나를 만들어 Twitter / Reddit / Polymarket 반응을 시간 단위로 시뮬레이션하는 엔진.

한 줄 요약

aaronjmars/MiroShark는 **“시나리오를 넣으면 여론·거래·대화가 시간축으로 전개되는 스웜 시뮬레이션 엔진”**이다. MiroFish 계열과 닮았지만, 더 명확하게 Twitter + Reddit + Polymarket의 교차 플랫폼 반응과 실행 경험을 강조한다.

핵심 요약

  • 사용자는 press release, policy draft, financial report, 질문, 역사적 가정 등 시드를 넣는다.
  • 시스템은 Neo4j 그래프를 만들고, 엔티티/관계/웹 검색을 묶어 페르소나를 생성한다.
  • 시뮬레이션은 Twitter, Reddit, Polymarket을 병렬로 돌리며, 에이전트는 서로 다른 플랫폼의 컨텍스트를 일부 공유한다.
  • 결과는 실제 게시물/댓글/트레이드에 기반한 리포트로 정리된다.
  • 중간에 에이전트를 직접 채팅하거나, breaking news를 주입하거나, timeline을 fork할 수 있다.

구조적으로 중요한 점

  • 그래프 + 스웜 + 시장 시뮬레이션이 한 패키지로 묶여 있다.
  • 단순한 social bot demo가 아니라, 여론 변화와 가격 반응을 함께 보는 실험 환경에 가깝다.
  • 런처가 강하다: ./miroshark 하나로 의존성 확인, Neo4j 기동, 설치, 서버 구동까지 묶는다.
  • 배포 경로가 다양하다: cloud API, Docker + Ollama, manual Ollama, Claude Code CLI.
  • Claude Code 모드까지 명시해서, 에이전트 개발자 친화성을 의도적으로 확보했다.

왜 중요한가

  • MiroFish 쪽이 문서 기반 여론 시뮬레이션의 원형에 가깝다면, MiroShark은 그 아이디어를 더 제품화된 런처 + 더 넓은 교차 플랫폼 시뮬레이션으로 밀어붙인 버전이다.
  • 특히 Polymarket을 포함시키는 점은, 단순한 텍스트 생성이 아니라 시장 신호와 사회 반응을 함께 보는 멀티에이전트 실험이라는 점에서 의미가 있다.
  • 로컬 Ollama 경로와 Claude Code 경로를 함께 제공하는 점도, 이 관심 두는 로컬/에이전트 친화 스택과 잘 맞는다.

관련 노트