br/acc: Open-Source Graph Infrastructure for Brazilian Civic Intelligence

Brazil's public data is legally open but scattered across dozens of government portals. br/acc changes that by creating a unified Neo4j knowledge graph that cross-references company registries, procurement records, health data, environmental sanctions, and more into actionable intelligence.

What Makes br/acc Unique?

• 45+ ETL Pipelines: Ingests data from Receita Federal (CNPJ), Portal da Transparencia, TSE elections, IBAMA embargoes, and 30+ other sources
• Privacy-First Design: LGPD compliant with public-safe defaults (no personal data exposure)
• Full-Stack Solution: Neo4j + FastAPI backend + React 19/TypeScript frontend
• One-Command Setup: make bootstrap-demo launches everything locally

Quick Start (5 Minutes)

cp .env.example .env
make bootstrap-demo

Access: - Frontend: http://localhost:3000 - API: http://localhost:8000/docs - Neo4j: http://localhost:7474

Production-Ready Architecture

Key Data Sources (All Legally Public)

1. CNPJ Company Registry (Receita Federal)
2. Portal da Transparencia (procurement, sanctions)
3. TSE Elections (donations, candidates)
4. IBAMA Embargoes (environmental)
5. DataSUS (health infrastructure)
6. TCU Audits + BNDES Loans

API Endpoints

GET /health                    # Health check
GET /api/v1/public/meta        # Source metrics
GET /api/v1/public/graph/company/{cnpj}  # Company subgraph

Legal Foundation

✅ CF/88 Art. 37 - Public information access ✅ Lei 12.527/2011 (LAI) - Freedom of Information ✅ LC 131/2009 - Fiscal transparency ✅ Lei 13.709/2018 (LGPD) - Public data processing allowed

Get Involved

• ⭐ Star the repo
• Join Discord
• Check open issues
• Run make bootstrap-all for full ingestion

br/acc proves decentralized builders can tackle institutional data silos. Fork, contribute, and build civic tools on Brazil's open data foundation.

Live Demo | Docs | bracc.org