br/acc: Brazil's Open Graph for Civic Intelligence

Discover br/acc, the open-source graph infrastructure that unifies Brazil's scattered public databases into a single queryable Neo4j graph. From company registries and procurement data to health records and environmental sanctions, this decentralized project makes government data actionable for civic improvement. Features 45+ ETL pipelines, React frontend, FastAPI backend, and one-command Docker bootstrap. LGPD-compliant and privacy-first, it's ready for local development with make bootstrap-demo.

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:

Production-Ready Architecture

Layer Technology
Graph DB Neo4j 5 Community
Backend FastAPI (Python 3.12+)
Frontend Vite + React 19 + TypeScript
ETL Python (pandas, httpx)
Infra Docker Compose

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