Skip to content

README.md

Latest commit

 

History

History
109 lines (77 loc) · 3.9 KB

README.md

File metadata and controls

109 lines (77 loc) · 3.9 KB
Raw

EGOS Inteligência — Plataforma Aberta de Cruzamento de Dados Públicos

Versão: 0.8.1 | Atualizado: 2026-07-17 | Status: PAUSA (features) · API interop VIVA Repo: github.com/enioxt/br-acc | Fork de: github.com/World-Open-Graph/br-acc Parte do ecossistema EGOS

2026-07-16 — Consumidor novo: DT-AJ (daniel-falencias) consome a API interop por CNPJ (quadro societário + sanções do devedor). 3 bugs do endpoint corrigidos e deployados (formato CNPJ, labels de sócio, qualificacao na relação — ver api/src/bracc/routers/interop.py). Pendente: ETL congelado a 90% desde 2026-04-02 (erro run_id) — uf/situacao/sócios/PGFN não terminaram de carregar; endpoint correto mas dado parcial até o revival.

Plataforma open-source para cruzamento de dados públicos brasileiros em grafo — 83M+ nós Neo4j, ETL pipeline, FastAPI, chatbot AI com 26 ferramentas OSINT.

Live: inteligencia.egos.ia.br · API: health check

⚠️ Nota para agentes IA: Este repo (br-acc) é o canonical do EGOS Inteligência. egos-lab/apps/egos-inteligencia está ARQUIVADO (migração abandonada de 2026-04). Não confundir. O pacote Python interno chama-se egos_inteligencia (namespace), mas vive dentro deste repo em api/src/egos_inteligencia/.

Para que serve

Conecta dados públicos do Brasil (empresas, políticos, contratos, sanções, doações eleitorais) em um grafo interativo que mostra quem se relaciona com quem.

[79 Fontes Planejadas] → [ETL Python] → [Neo4j Grafo] → [FastAPI + Redis] → [React + Bots AI]

Estado atual do banco

Entidade Quantidade
Nós Neo4j 83.773.683
Labels 32
Relações 26.808.540

O que está dentro

Dados Fonte Volume
Empresas e sócios CNPJ (Receita Federal) 53,6M empresas
Doações eleitorais TSE 7,1M registros (2002-2024)
Contratos federais Portal da Transparência 1,1M contratos
Empresas punidas CEIS, TCU, IBAMA, CVM 150k sanções
Dívidas com a União PGFN 24M débitos
Diário Oficial DOU 3,98M atos
Gastos de deputados Câmara (CEAP) 4,6M despesas
Offshores ICIJ (Panama/Paradise/Pandora Papers) 4,8k entidades
Processos no STF STF 2,38M casos

Stack

Componente Tecnologia
Banco de Dados Neo4j 5 Community (grafo)
Cache Redis 7 (512MB LRU)
Backend FastAPI (Python 3.12, assíncrono)
Frontend React 19 + Vite (mobile-first)
ETL Python com pandas (45 pipelines)
Bots Discord.js + Telegraf + AI Router (OpenRouter)
Infra Docker Compose + Caddy + Hetzner VPS

Quick Start

git clone https://github.com/enioxt/EGOS-Inteligencia.git
cd EGOS-Inteligencia
cp .env.example infra/.env  # NEO4J_PASSWORD + API keys
cd infra && docker compose up -d
bash scripts/seed-dev.sh    # ~1000 entidades demo

Compliance LGPD

  • CPF bloqueado em todo o sistema — busca, exibição, exportação
  • Middleware de masking intercepta qualquer CPF nas respostas JSON
  • Apenas CNPJ e dados públicos por lei são exibidos

Ecossistema EGOS — Dependências

Repo Relação Status
egos Kernel upstream — Guard Brasil LGPD, governança, 24 agents AI PROD

Upstream (o que este repo usa): Guard Brasil (CPF masking + LGPD compliance), padrões de governança .guarani/, event bus types.

Downstream (quem usa este repo): produto independente — nenhum repo depende dele.

Licença

GNU Affero General Public License v3.0 — código aberto, copyleft.

"Dados públicos são sinais, não prova jurídica. Nossa missão é torná-los acessíveis a todos."