DEV Community

Cover image for MiroFish: Motor de IA Open Source para Prever Tudo
Lucas
Lucas

Posted on • Originally published at apidog.com

MiroFish: Motor de IA Open Source para Prever Tudo

A inteligência artificial está evoluindo rapidamente, mas a maior parte das ferramentas de IA ainda segue um padrão tradicional: você envia um prompt para um modelo e recebe uma resposta.

Experimente o Apidog hoje mesmo

Nos últimos anos, porém, as simulações multiagente começaram a ganhar espaço: sistemas em que múltiplos agentes de IA interagem em um ambiente digital compartilhado, trocando informações, formando opiniões e influenciando-se mutuamente.

Um dos projetos mais relevantes desse segmento é o MiroFish, um motor open source de inteligência de enxame. Ele permite simular cenários do mundo real com milhares de agentes de IA, criando um sandbox digital onde eventos – mercados financeiros, mudanças de opinião pública, reações políticas, ou até narrativas fictícias – podem ser testados antes que ocorram de fato.

💡 Dica: Se você trabalha com agentes de IA ou servidores MCP, o Apidog oferece um Cliente MCP integrado para depurar e testar servidores MCP facilmente. Suporte a STDIO, HTTP, autenticação OAuth 2.0, visualização de Markdown e imagens — tudo em uma interface visual intuitiva.

Ao contrário dos modelos tradicionais, o MiroFish cria uma sociedade digital de agentes de IA. Cada agente possui memória, traços de personalidade e lógica própria de decisão. Diante de um novo evento — seja uma notícia de última hora, uma política ou um sinal financeiro — os agentes interagem e reagem, influenciando uns aos outros, gerando padrões de comportamento semelhantes aos de grupos reais.

Exemplo de visualização MiroFish
Fonte: X

O Que É MiroFish?

Interface do MiroFish

O MiroFish é um motor de simulação de inteligência de enxame baseado em múltiplos agentes autônomos.

Ao invés de depender de um único modelo de IA, ele gera uma população de agentes, cada qual representando um indivíduo em uma sociedade virtual. Cada agente tem:

  • traços de personalidade
  • regras comportamentais
  • memória de longo prazo
  • relações sociais
  • lógica de decisão própria

Esses agentes trocam informações, formam opiniões e reagem a eventos, gerando comportamento emergente — resultados macro surgem de interações micro, como em sociedades reais. Assim, o MiroFish funciona como um sandbox digital para explorar cenários "e se".

A Visão: Espelho da Inteligência Coletiva

Espelho da inteligência coletiva

O objetivo do MiroFish é ser um espelho digital da inteligência coletiva.

Diferente de sistemas preditivos que dependem apenas de dados históricos e estatística, o MiroFish simula interações sociais: mercados reagem ao sentimento dos investidores, tendências de mídia se espalham imprevisivelmente, opiniões públicas mudam rápido. Ao criar um ambiente digital para essas interações, o MiroFish permite observar o surgimento de resultados complexos naturalmente.

De Dados Semente a Um Mundo Digital

Construção do mundo digital

Para rodar uma simulação, é preciso fornecer um material semente: informações que definem o cenário desejado, como:

  • artigos de notícias
  • relatórios financeiros
  • documentos de política
  • pesquisas
  • discussões de redes sociais
  • histórias fictícias

O usuário carrega esse material e descreve o objetivo de previsão em linguagem natural. Exemplos:

  • "Simule como o mercado reage a uma nova política"
  • "Como o público responderia a uma declaração controversa?"
  • "Como uma história evoluiria se um capítulo fosse alterado?"

O sistema constrói um ambiente digital no qual os agentes podem interagir, criando um mundo paralelo para o experimento.

Fluxo de Trabalho do MiroFish: Pipeline de Simulação

Pipeline do MiroFish

O MiroFish transforma dados do mundo real em simulações dinâmicas seguindo um pipeline:

1. Construção do Grafo de Conhecimento

Grafo de conhecimento

Primeiro, as informações semente são extraídas e organizadas em um grafo de conhecimento (GraphRAG), definindo entidades, relações e contexto. Estruturas de memória individuais e coletivas são injetadas para garantir contexto histórico aos agentes.

2. Geração do Ambiente

Geração do ambiente

Com o grafo pronto, o ambiente é montado. Isso inclui:

  • extração de entidades/relacionamentos
  • criação de personas de agentes
  • construção de rede social
  • configuração de parâmetros

Cada agente recebe identidade, histórico e regras comportamentais, simulando dinâmicas sociais reais.

3. Execução Paralela da Simulação

Milhares de agentes operam em paralelo, reagindo a eventos e interagindo. O sistema simula:

  • interpretação do objetivo de previsão
  • interações sociais
  • atualização de memórias
  • evolução dinâmica do ambiente

Assim, narrativas e comportamentos evoluem ciclo a ciclo.

4. Geração de Relatórios

Após múltiplos ciclos, o componente de IA ReportAgent analisa os resultados. Ele gera um relatório estruturado com:

  • resultados-chave
  • tendências
  • insights comportamentais
  • potenciais riscos

Esse relatório orienta a análise dos usuários sobre as possíveis implicações do experimento.

5. Interação Profunda com a Simulação

Interação com agentes

O diferencial do MiroFish está na interatividade: é possível conversar com agentes específicos, questionar decisões e explorar dinâmicas sociais, além de interagir com o ReportAgent para análises detalhadas.

Início Rápido: Como Rodar o MiroFish Localmente

Se você é desenvolvedor e quer experimentar a plataforma, pode implantá-la localmente via código fonte ou Docker.

Requisitos do Sistema

Ferramenta Versão Propósito
Node.js 18+ Runtime do frontend
Python 3.11–3.12 Backend Python
uv Mais recente Gerenciador de pacotes Python

Verifique a instalação:

node -v
python --version
uv --version
Enter fullscreen mode Exit fullscreen mode

Passo 1: Configurar Variáveis de Ambiente

Copie o arquivo de exemplo:

cp .env.example .env
Enter fullscreen mode Exit fullscreen mode

Edite .env e adicione as chaves de API necessárias.

Exemplo de configuração LLM:

LLM_API_KEY=sua_chave_api
LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
LLM_MODEL_NAME=qwen-plus
Enter fullscreen mode Exit fullscreen mode

Recomendado: use o modelo Qwen (Bailian/Alibaba). Para testes, limite simulações a menos de 40 rodadas para não sobrecarregar recursos.

Configuração do sistema de memória (Zep Cloud):

ZEP_API_KEY=sua_chave_api_zep
Enter fullscreen mode Exit fullscreen mode

O plano gratuito do Zep Cloud é suficiente para testes iniciais.


Passo 2: Instalar Dependências

Instale tudo de uma vez:

npm run setup:all
Enter fullscreen mode Exit fullscreen mode

Ou por etapas:

npm run setup         # Dependências Node
npm run setup:backend # Dependências Python (cria venv automaticamente)
Enter fullscreen mode Exit fullscreen mode

Passo 3: Iniciar a Plataforma

Para iniciar frontend e backend juntos:

npm run dev
Enter fullscreen mode Exit fullscreen mode

Serviços disponíveis em:

  • Frontend: http://localhost:3000
  • Backend API: http://localhost:5001

Para rodar separadamente:

npm run backend   # Apenas backend
npm run frontend  # Apenas frontend
Enter fullscreen mode Exit fullscreen mode

Implantação Docker

Prefere ambiente conteinerizado? O MiroFish suporta Docker.

  1. Configure o .env como descrito.
  2. Inicie os containers:
docker compose up -d
Enter fullscreen mode Exit fullscreen mode

Portas padrão:

  • 3000: interface frontend
  • 5001: API backend

O arquivo Docker inclui opções de espelhamento para acelerar downloads de imagem, se necessário.

Considerações Finais

Futuro das simulações

Simulações multiagente como o MiroFish representam um novo estágio para IA: ambientes digitais para testar políticas, prever reações de mercado ou estudar a disseminação de informações. Embora não sejam perfeitos — a imprevisibilidade humana sempre será um desafio —, esses sistemas abrem espaço para experimentação e apoio à decisão em escala inédita.

Projetos como o MiroFish mostram o potencial da IA para além da geração de respostas: a modelagem de sociedades inteiras. Para desenvolvedores, pesquisadores e empresas, pode ser o primeiro passo rumo a soluções de previsão realmente avançadas.


Links úteis:

Top comments (0)