Fork adaptado para o contexto brasileiro: simulação político-eleitoral, jurídico-institucional e análise de crise.
Posicionamento metodológico: Vox Science Harness opera com 11 artefatos auditáveis, métricas Wasserstein/KL/MAE/DPD, teto epistêmico r ≤ 0.50 para construtos latentes, teste-cego de variáveis-alvo e gate científico bloqueando paridade demográfica acima de 15%. Calibração com painel humano fica em roadmap contingente.
Sobre · O que mudou no fork · Como Rodar · Deploy · Documentação
🤖 Agentes IA (Claude Code, Codex, Cursor, Copilot): leiam
CLAUDE.mdeAGENTS.mdantes de editar qualquer arquivo. Múltiplas instâncias trabalham em paralelo neste repositório — a coordenação está documentada lá.
MiroFish é um motor de previsão baseado em múltiplos agentes, originalmente criado por 666ghj. Transforma sinais do mundo real — notícias, relatórios, políticas, narrativas — em um ambiente digital onde agentes com memória, personalidade e lógica de ação próprias interagem para produzir dinâmicas sociais emergentes.
Material-base → Extração de conhecimento → Grafo de entidades
↓
Configuração do ambiente → Perfis dos agentes → Relações
↓
Simulação paralela → Interações multiagente → Memória temporal
↓
Relatório analítico → Conversa com agentes → Insights
| Aspecto | MiroFish Original | Fork INTEIA |
|---|---|---|
| Idioma | Chinês/Inglês | Português brasileiro completo |
| Contexto | Acadêmico genérico | Político-eleitoral, jurídico, crise |
| LLM Gateway | OpenAI direto | OmniRoute (custo zero) + fallback Anthropic |
| Memória | Zep Cloud obrigatório | Zep opcional, fallback keyword |
| Segurança | Básica | Headers CSP, CORS, iframe policy |
| Deploy | Local | Docker multi-stage + nginx em VPS |
| Relatório | ReportAgent padrão | Helena Strategos (analista-chefe INTEIA) |
| Tradução | — | i18n completo, conteúdo forçado em PT-BR |
| Performance | — | Timeout LLM 90s, fallback strategies |
| Persistência | — | State em disco (tasks_state.json) |
| Mobile | — | Responsivo (breakpoints 480px) |
| Enriquecimento | — | Apify (Google SERP + Instagram) para contexto factual |
| QC do relatório | — | Overlap upload×relatório (jaccard 5-gram, alerta >30%) + gate editorial por seção |
| Gate de entrega | — | Bloqueio estrutural de relatório sem simulação concluída, evidência local, diversidade mínima, trace OASIS com ação social real e auditoria de citações |
| Auditoria numérica | — | Percentuais, probabilidades e contagens precisam estar no corpus ou marcados como inferência calibrada |
| Interface de gate | — | Step 03 consulta qualidade sistêmica e bloqueia o botão de relatório quando o gate reprova |
| Dinâmica social | — | Pulso social inicial configurável no OASIS para gerar comentários, curtidas, rejeições, reposts e citações auditáveis |
| Governança cliente/demo | — | Modo client é estrito e publicável só com gate completo; demo/smoke fica sempre como diagnostic_only |
| Anti-viés | — | Devil's advocate em ~20% dos perfis + diversidade intra-grupo |
| Helena cenários | Análise narrativa | Tabela obrigatória de 3 cenários probabilísticos (Base/Otimista/Contrário, soma=100%) |
| Centro de comando Helena | — | Caixa global com contexto de fase, plano prévio, aprovação de uso único e auditoria |
| Testes | — | 390 testes backend e 8 testes focados do executor Helena validados na publicação de 2026-07-24 |
Use Alt+H em qualquer fase para abrir a caixa global. A Helena pode inspecionar
o estado atual, continuar um processo existente ou coordenar uma análise
completa usando exclusivamente as APIs canônicas do MiroFish. Ações que alteram
o processo exigem confirmação explícita e ficam registradas em auditoria.
Configuração, ferramentas permitidas, limites e roteiro de homologação estão em
docs/ops/HELENA_CONTROL_PLANE.md.
O estado efetivamente publicado, os hashes, o rollback e as evidências estão em
docs/ops/PUBLICACAO_HELENA_2026-07-24.md.
- Simulação eleitoral — cenários de campanha, repercussão de narrativa
- Análise jurídico-institucional — dinâmicas entre atores do sistema de justiça
- Crise reputacional — evolução de narrativa e opinião pública
- Testes de narrativa — impacto de diferentes abordagens comunicacionais
- Pesquisa sintética — integração com FlockVote (MAE 4.4pp no DF 2022)
mirofish-inteia/
├── backend/ # Python 3.11 + Flask
│ ├── app/
│ │ ├── services/ # Gerenciador de simulação, ontologia, LLM, Apify
│ │ └── utils/ # Cliente LLM, Graphiti, Zep
│ ├── scripts/ # Simulação paralela, proxy LLM, enrich_project
│ └── tests/
│
├── frontend/ # Vue.js 3 + Vite
│ ├── src/
│ │ ├── views/ # Home, simulação, relatório
│ │ └── api/ # Cliente da API
│ └── public/
│
├── deploy/ # Configurações de deploy
├── docker-compose.yml # Orquestração de containers
├── Dockerfile # Build multi-stage
│
├── PRD_MIROFISH_INTEIA_V2.md # Product Requirements Document
├── BACKLOG_TECNICO_*.md # Backlog técnico
├── PLANO_ADAPTACAO_*.md # Plano de adaptação do fork
└── MAPEAMENTO_PT-BR.md # Mapeamento de tradução
| Ferramenta | Versão | Verificação |
|---|---|---|
| Node.js | 18+ | node -v |
| Python | 3.11 | python --version |
| uv | atual | uv --version |
# Clone o fork
git clone https://github.com/igormorais123/MiroFish.git
cd MiroFish
# Configure variáveis de ambiente
cp .env.example .env
# Edite .env com suas chaves
# Instale tudo
npm run setup:all
# Rode
npm run devEndereços padrão:
- Frontend:
http://localhost:5173 - Backend API:
http://localhost:5001
# LLM (via OmniRoute ou OpenAI-compatible)
LLM_API_KEY=sua_chave
LLM_BASE_URL=http://localhost:20128 # OmniRoute local
LLM_MODEL_NAME=BestFREE
# Zep Cloud (opcional)
ZEP_API_KEY=sua_chave_zepcp .env.example .env
docker compose up -dEm desenvolvimento, consulte o docker-compose.yml vigente antes de expor
portas. Em produção, nenhuma porta de aplicação é endereço público: o acesso é
feito exclusivamente pelo nginx em https://inteia.com.br/mirofish/.
O deploy público canônico está na VPS hermes, no checkout
/opt/mirofish-git, com frontend e backend no container mirofish-inteia.
Toda publicação deve partir de main, criar backup e imagem de rollback e
terminar com smoke tests públicos:
cd /opt/mirofish-git
git fetch origin
git pull --ff-only origin main
docker compose build mirofish
docker compose up -d mirofish
curl -fsS https://inteia.com.br/mirofish/api/health
curl -fsS https://inteia.com.br/mirofish/api/helena/statusUse o procedimento completo, com rollback, em
docs/ops/COMANDOS_SEGUROS_MIROFISH.md.
O Mirofish pode coletar fatos web e perfis sociais reais via Apify antes de construir o grafo, aumentando a fidelidade dos agentes simulados.
O painel "Enriquecimento Apify" aparece antes da geração de perfis. Fontes disponíveis:
- Buscas Google: fatos web atualizados sobre o caso
- Perfis Instagram: bio, seguidores, categoria, verificação
- Posts recentes Instagram: legendas, curtidas, comentários, menções, hashtags
- Tagged posts: quem marcou os atores em publicações
- Comentários YouTube: opinião pública em vídeos relacionados
- Extração automática: checkbox que detecta @handles, queries e URLs do briefing
Os dados coletados são injetados no texto-base antes da construção do grafo. Cache em disco evita reprocessamento.
POST /api/simulation/prepare
{
"simulation_id": "sim_xxxx",
"enrich_queries": ["reforma tributária PEC 45"],
"enrich_actors": ["acmneto", "brunoreisba"],
"enrich_ig_posts": ["acmneto"],
"enrich_ig_tagged": ["acmneto"],
"enrich_youtube": ["https://youtube.com/watch?v=..."],
"enrich_auto": true
}cd backend
python scripts/enrich_project.py \
--project-id <id> \
--query "reforma tributária PEC 45" \
--actor acmneto \
--dry-run # mostra bloco sem salvar| Operação | Custo aproximado |
|---|---|
| Google SERP (1 query, 8 resultados) | US$ 0,002 |
| Perfil Instagram (1 handle) | US$ 0,0015 |
| Posts Instagram (5 posts) | US$ 0,003 |
| Tagged posts (5 posts) | US$ 0,003 |
| Comentários YouTube (20 comentários) | US$ 0,005 |
| Enriquecimento completo (10 queries + 5 atores) | US$ 0,07 |
Requer conta Apify com token em APIFY_TOKEN. O Mirofish prossegue normalmente se o Apify falhar.
| Documento | Descrição |
|---|---|
| PRD v2 | Requisitos do produto |
| Backlog Técnico | Tasks técnicas pendentes |
| Plano de Adaptação | Roadmap do fork |
| Estado Atual | Status real da implementação, validações e pendências |
| Roadmap Atual | Próximas fases após o gate estrutural |
| Mapa de Documentação | Onde ficam planos, mapas técnicos, memória e arquivos históricos |
| Mapa Arquitetural do Sistema | Topologia navegável do produto, Helena, serviços e produção |
| Mapa Arquitetural da Helena | Fluxo detalhado do centro de comando e seus controles |
| Grafo Estrutural | Grafo navegável gerado pelo Graphify a partir do repositório |
| Operação da Helena | Contrato de ferramentas, autorização, auditoria e limites |
| Publicação da Helena | Evidências de deploy, testes e rollback de 2026-07-24 |
| Plano Consultoria Simulada | Implementação estrutural da promessa INTEIA de simular, verificar e entregar |
| Mapas Técnicos | Estrutura, arquitetura, integrações, testes e riscos do código |
| GPT da Pasta | Índice consolidado de ativos, documentos, mapas Mermaid e leitura para IA |
| Mapa Mental IA | HTML navegável com SVG, busca e mapa visual completo para estudo por IA |
| Auditoria do Mapa IA | Achados, ajustes e limites dos artefatos de mapa criados |
| Aprendizados Consultoria Auditável | Aprendizados e decisões da fase v1.3 |
| Mapeamento PT-BR | Referência de tradução |
| Integração Lenia | Ponte com sistema eleitoral |
Fork de MiroFish por 666ghj, baseado no framework OASIS (CAMEL-AI). O motor de simulação é impulsionado pelo grupo Shanda.
- Vila INTEIA — Campus 3D com 144 consultores lendários simulados
- OmniRoute — Gateway LLM inteligente (custo zero)
Fork mantido por Igor Morais Vasconcelos
INTEIA — Inteligência Artificial Estratégica