Skip to main content

Brazilian Public DataGraph Infrastructure

Cross-reference 45+ Brazilian public databases in a unified Neo4j graph. Explore corporate networks, track public spending, and analyze entity connections with LGPD-compliant transparency tools.

Get StartedAPI Reference

Quick Start

Get BR-ACC running locally in minutes with Docker Compose

1

Clone and configure

Clone the repository and set up your environment variables:
git clone https://github.com/World-Open-Graph/br-acc.git
cd br-acc
cp .env.example .env
Edit .env to set your Neo4j password and other configuration values.
2

Start the stack

Launch all services (Neo4j, API, and frontend) with Docker Compose:
docker compose up -d --build
This starts:
  • Neo4j on ports 7474 (browser) and 7687 (bolt)
  • FastAPI backend on port 8000
  • React frontend on port 3000
3

Load demo data

Seed the graph with deterministic development data:
bash infra/scripts/seed-dev.sh
Check that all services are running:
4

Run your first query

Open the Neo4j Browser at http://localhost:7474 and try this Cypher query:
MATCH (c:Company)
RETURN c.razao_social, c.cnpj
LIMIT 10
Or use the API to fetch company data:
curl http://localhost:8000/api/v1/public/meta

Explore the Platform

Deep dive into the data model, ETL pipelines, and query interfaces

Data Model

Understand the Neo4j graph schema with 45+ entity types and relationship patterns

ETL Pipelines

Learn how 45+ data sources are ingested, normalized, and loaded into the graph

Query Guide

Master Cypher queries to explore corporate networks and entity connections

Deployment

Deploy BR-ACC with Docker, configure production settings, and scale your instance

Key Features

Built for transparency, reproducibility, and LGPD compliance

45+ Data Sources

ETL pipelines for Brazilian public databases including CNPJ, TSE elections, Portal da Transparência, and more

Neo4j Graph Database

Normalized entities and relationships with full-text search, constraints, and optimized indexes

Privacy-First Design

LGPD compliant with public-safe defaults, CPF masking, and no personal data exposure

FastAPI Backend

Async Python 3.12+ API with public and authenticated endpoints, rate limiting, and OpenAPI docs

React Frontend

Vite + React 19 + TypeScript interface for exploring corporate networks and entity connections

One-Command Bootstrap

Reproducible local environment with Docker Compose and deterministic seed data

API Reference

Public and authenticated endpoints for programmatic access

Public Endpoints

Access aggregated metrics, company subgraphs, and pattern analysis without authentication

Graph Operations

Search entities, explore relationships, and traverse the graph programmatically

Authentication

Register users, obtain JWT tokens, and access protected endpoints

Rate Limits

Understand rate limiting, pagination, and API best practices

Ready to explore Brazilian public data?

Join the br/acc movement and start building transparency tools with open data. Star the repo on GitHub and join our Discord community.

Get StartedStar on GitHubJoin Discord