Language: English | Português (Brasil)

BRACC Open Graph is an open-source graph infrastructure for public data intelligence. Primary website: bracc.org

BRACC Open Graph is an initiative from World Open Graph. This repository contains the full code for the public BRACC edition.

• Public-interest graph infrastructure for transparency work.
• Reproducible ingestion and processing for public records.
• Investigative signals with explicit methodological caution.

Data patterns from public records are signals, not legal proof.

• Public API (api/)
• ETL pipelines and downloaders (etl/, scripts/)
• Frontend explorer (frontend/)
• Infrastructure and schema bootstrap (infra/)
• Documentation, legal pack, and release gates (docs/, root policies)

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

cp .env.example .env
# set at least NEO4J_PASSWORD

make dev

export NEO4J_PASSWORD=your_password
make seed

• API: http://localhost:8000/health
• Frontend: http://localhost:3000
• Neo4j Browser: http://localhost:7474

• api/: FastAPI app, routers, Cypher query loading
• etl/: pipeline definitions and ETL runtime
• frontend/: React application for graph exploration
• infra/: Neo4j initialization and compose-related infra
• scripts/: operational and validation scripts
• docs/: legal, release, and dataset documentation

Use these defaults for public deployments:

• PRODUCT_TIER=community
• PUBLIC_MODE=true
• PUBLIC_ALLOW_PERSON=false
• PUBLIC_ALLOW_ENTITY_LOOKUP=false
• PUBLIC_ALLOW_INVESTIGATIONS=false
• PATTERNS_ENABLED=false
• VITE_PUBLIC_MODE=true
• VITE_PATTERNS_ENABLED=false

# dependencies
cd api && uv sync --dev
cd ../etl && uv sync --dev
cd ../frontend && npm install

# quality
make check
make neutrality

Contributions are welcome. Start with CONTRIBUTING.md for workflow, quality gates, and review expectations.

• Bruno Cesar — creator and maintainer
• Codex — AI-assisted engineering contributor

• ETHICS.md
• LGPD.md
• PRIVACY.md
• TERMS.md
• DISCLAIMER.md
• SECURITY.md
• ABUSE_RESPONSE.md
• docs/legal/legal-index.md

GNU Affero General Public License v3.0