docs.campaignbrain.dev · the library

The platform, documented.

Architecture, guides, and a reference page for every service — the same docs our own agents read. Indexed straight from the cbdocs repo, so this library is exactly as current as the platform.

85
Documents
56k
Words
8
Sections
Service Catalogupdated Mar 2026

cbemail API

imap, smtp, email-send, email-read, mailbox, batch-send

Read the doc 260 wordscatalog/cbemail.md
Service Catalogupdated Mar 2026

Campaign Brain Service Catalog

API reference for 42 Campaign Brain microservices.

Read the doc 1,554 wordscatalog/index.md
Service Catalogupdated Feb 2026

CBAI

chat, embeddings, ocr, summarization, topics, tool-use, streaming

Read the doc 256 wordscatalog/cbai.md
Service Catalogupdated Feb 2026

CBAuth

CBAuth is the authentication and authorization service for the Campaign Brain ecosystem (.nominate.ai). It provides user-based login with JWT tokens, group-based permissions with hierarchical dot-notation, and Redis-cached permission…

Read the doc 387 wordscatalog/cbauth.md
Service Catalogupdated Feb 2026

Traffic Capture

Distributed tcpdump traffic capture analysis API. Browse pcap captures from OpenWRT worker fleet, inspect manifests, download files, and analyze traffic patterns across devices.

Read the doc 139 wordscatalog/cbcapture.md
Service Catalogupdated Feb 2026

CBComfy

Thin FastAPI proxy for ComfyUI generative AI backend.

Read the doc 142 wordscatalog/cbcomfy.md
Service Catalogupdated Feb 2026

CBCron

cron-scheduling, http-dispatch, job-management, retry-logic, run-history

Read the doc 165 wordscatalog/cbcron.md
Service Catalogupdated Feb 2026

Congressional Districts API

RESTful API providing comprehensive data for all 441 U.S. Congressional Districts (119th Congress, 2025-2027). Combines Census Bureau demographics with geospatial boundaries and Wikipedia-sourced political information.

Read the doc 568 wordscatalog/cbdistricts.md
Service Catalogupdated Feb 2026

Documentation Site

MkDocs Material documentation hub for the Campaign Brain platform. Architecture guides, service docs, API catalog, development guides, style guide.

Read the doc 89 wordscatalog/cbdocs.md
Service Catalogupdated Feb 2026

cbetl

CB ETL provides address normalization and parsing services for Campaign Brain.

Read the doc 134 wordscatalog/cbetl.md
Service Catalogupdated Feb 2026

CBFiles

File management service wrapping MinIO object storage. Provides a simple REST API for managing buckets and files with API key authentication.

Read the doc 545 wordscatalog/cbfiles.md
Service Catalogupdated Feb 2026

CBFront

email, conversations, messages, drafts, contacts, tags, templates, teammates, comments, analytics, channels, mcp-tools

Read the doc 277 wordscatalog/cbfront.md
Service Catalogupdated Feb 2026

cbgeo

Geocoding service for Campaign Brain using Nominatim with OpenStreetMap data.

Read the doc 119 wordscatalog/cbgeo.md
Service Catalogupdated Feb 2026

CBIndex

CBIndex is a FastAPI wrapper around PageIndex, a vectorless RAG system that transforms documents into hierarchical tree structures optimized for LLM-based reasoning retrieval.

Read the doc 292 wordscatalog/cbindex.md
Service Catalogupdated Feb 2026

CBInfra API

Infrastructure inventory, GitHub issues, project bootstrap, config management, and AI orchestration for CB projects.

Read the doc 572 wordscatalog/cbinfra.md
Service Catalogupdated Feb 2026

cbintel Intelligence API

crawl, screenshot, transcript, documents, workspaces, scheduler, planner, jobs

Read the doc 590 wordscatalog/cbintel.md
Service Catalogupdated Feb 2026

CBIssues

issues-crud, comments, labels, project-boards, multi-repo, mcp-tools

Read the doc 211 wordscatalog/cbissues.md
Service Catalogupdated Feb 2026

CBLinks

URL shortener service for creating and managing short links.

Read the doc 214 wordscatalog/cblinks.md
Service Catalogupdated Feb 2026

CB Logs

Read-only API for querying and searching logs across DC0 (impera).

Read the doc 256 wordscatalog/cblogs.md
Service Catalogupdated Feb 2026

cbmaps - City Map Poster Service

API for generating beautiful minimalist map posters for any city worldwide.

Read the doc 152 wordscatalog/cbmaps.md
Service Catalogupdated Feb 2026

MCP Service Catalog

MCP server exposing the CB service catalog to LLM agents. SSE transport for remote clients, Inspector UI for humans.

Read the doc 105 wordscatalog/cbmcp.md
Service Catalogupdated Feb 2026

apimesh

WebSocket gateway for the API Mesh network

Read the doc 164 wordscatalog/cbmesh.md
Service Catalogupdated Feb 2026

cbmobile

Progressive Web App for door-knocking and canvassing. Offline-first with RxDB sync, DuckDB analytics, offline maps. iOS Safari optimized.

Read the doc 143 wordscatalog/cbmobile.md
Service Catalogupdated Feb 2026

Voter Analysis

AI-powered voter segment analysis, behavioral enrichment, campaign data, voter search, and address hygiene.

Read the doc 190 wordscatalog/cbmodels.md
Service Catalogupdated Feb 2026

CBOS

Claude Code Operating System - Session Manager

Read the doc 253 wordscatalog/cbos.md
Service Catalogupdated Feb 2026

CB Overseer

CB Overseer is the central system manager for Campaign Brain infrastructure. It coordinates monitoring agents, collects telemetry, manages incidents, and enables self-healing through AI-powered diagnosis and learned remediation.

Read the doc 524 wordscatalog/cboverseer.md
Service Catalogupdated Feb 2026

CB Payments

donations, campaigns, donors, reporting, merchant-accounts

Read the doc 239 wordscatalog/cbpayments.md
Service Catalogupdated Feb 2026

Public Marketing Website

Campaign Brain public marketing website. Landing pages, feature overview, contact forms. Jinja2 templates served via FastAPI.

Read the doc 57 wordscatalog/cbpublic.md
Service Catalogupdated Feb 2026

CBPulse

auth, businesses, alerts, financials, occupancy, employees, guests, inbox, mcp-tools

Read the doc 1,696 wordscatalog/cbpulse.md
Service Catalogupdated Feb 2026

Rural AM/FM Rate Ingestion API

The Rural AM/FM Rate Ingestion API provides programmatic access to radio station political advertising rates for AI-powered media buying applications. It enables campaign managers and media buyers to query rates, build proposals, and…

Read the doc 3,301 wordscatalog/cbradio.md
Service Catalogupdated Feb 2026

CBRouter

MCP/API frontend for OpenWRT router management.

Read the doc 445 wordscatalog/cbrouter.md
Service Catalogupdated Feb 2026

CB Scout

CB Scout provides agent memory and knowledge management capabilities for Campaign Brain AI agents. It implements a hierarchical memory system with automatic categorization, temporal awareness, and decay.

Read the doc 238 wordscatalog/cbscout.md
Service Catalogupdated Feb 2026

CBSMS Gateway

sms-send, mms-send, bulk-sms, device-control, webhooks

Read the doc 251 wordscatalog/cbsms.md
Service Catalogupdated Feb 2026

CBSocial

WhatsApp message ingestion and API access for Campaign Brain

Read the doc 204 wordscatalog/cbsocial.md
Service Catalogupdated Feb 2026

CB Surveys

A REST API for creating surveys, managing questions, and collecting responses. Designed for programmatic integration with AI-directed platforms and automation systems.

Read the doc 360 wordscatalog/cbsurveys.md
Service Catalogupdated Feb 2026

Test Bootstrap API

Test project for CBApp bootstrap template validation. Minimal API used to verify project scaffolding and deployment pipeline.

Read the doc 67 wordscatalog/cbtest.md
Service Catalogupdated Feb 2026

CBTiles API

tiles, map-tiles, caching, cartodb, basemap, prefetch

Read the doc 135 wordscatalog/cbtiles.md
Service Catalogupdated Feb 2026

TOR Management API

TOR Management API provides anonymous web fetching through a pool of Tor-enabled OpenWRT workers. Each worker runs Tor connected via WireGuard tunnels, with automatic health monitoring, circuit rotation, and self-healing recovery.

Read the doc 256 wordscatalog/cbtor.md
Service Catalogupdated Feb 2026

Unstructured Pipeline API

Document parsing and element extraction via Unstructured library. PDF, DOCX, images, email, markdown.

Read the doc 104 wordscatalog/cbunstruct.md
Service Catalogupdated Feb 2026

cbuserguide

documentation, screenshots, playwright, crawling, markdown, user-guide

Read the doc 281 wordscatalog/cbuserguide.md
Service Catalogupdated Feb 2026

cbvpn Network API

The cbintel Network API manages a distributed VPN cluster for geographic routing. It controls OpenWRT-based workers that provide geographically-targeted exit points for web scraping and intelligence gathering operations.

Read the doc 569 wordscatalog/cbvpn.md
Service Catalogupdated Feb 2026

CBWebhook

typeform-webhooks, event-storage, form-responses, consumer-management

Read the doc 186 wordscatalog/cbwebhook.md
Service Catalogupdated Feb 2026

CB Workflow Engine

Lightweight JSON-backed workflow engine for CRM contact management. Manages contacts, workflow templates, and workflow instances with full state tracking and event timeline.

Read the doc 1,094 wordscatalog/cbworkflow.md
Referenceupdated Feb 2026

Campaign Brain Inventory

Complete inventory of all Campaign Brain services, domains, and infrastructure.

Read the doc 1,962 wordsreference/inventory.md
Developmentupdated Feb 2026

API Documentation Standard for Nominate.AI

This document defines the standard for FastAPI/OpenAPI documentation across all Nominate.AI services. The gold standard reference is models.nominate.ai (/docs | /redoc).

Read the doc 2,073 wordsdevelopment/api-docs-standard.md
Referenceupdated Feb 2026

API Service Catalog

Complete reference of all Campaign Brain API services, endpoints, and authentication methods.

Read the doc 4,196 wordsreference/api-catalog.md
Platformupdated Feb 2026

Geographic boundary data for Michigan, Kentucky, and Iowa

All three states have free, ready-to-use state and county boundary data from multiple sources. The Census Bureau’s TIGER/Line program provides the authoritative national standard, with 2024/2025 vintages currently available in shapefile…

Read the doc 1,519 wordsresearch/geographic-boundaries.md
Referenceupdated Jan 2026

Raw Documentation by Project

Browse all documentation files for each Campaign Brain component. This page lists every markdown file in each project's docs/ directory.

Read the doc 1,644 wordsreference/raw-docs.md
Guidesupdated Jan 2026

Documentation Refresh Process

This guide documents the process for refreshing Campaign Brain documentation when platform modules are updated. It is designed for both AI assistants (Claude Code) and human operators.

Read the doc 897 wordsguides/docs-refresh-process.md
Platformupdated Jan 2026

Campaign Brain

Welcome to the Campaign Brain platform - a multi-tenant SaaS for political campaign management.

Read the doc 691 wordsindex.md
Platformupdated Jan 2026

Campaign Brain Documentation

Welcome to the Campaign Brain platform documentation. Campaign Brain is a multi-tenant SaaS platform for political campaign management.

Read the doc 1,871 wordsoverview.md
Referenceupdated Jan 2026

Development Status

This page is auto-generated by scripts/refreshdevstatus.sh.

Read the doc 1,045 wordsreference/dev-status.md
Architectureupdated Dec 2025

CampaignBrain Database Architecture

The CampaignBrain system uses two different database systems for different purposes:

Read the doc 957 wordsarchitecture/database.md
Architectureupdated Dec 2025

Database Architecture

Campaign Brain uses a mix of SQLite and DuckDB databases across its services. This page documents all active databases, their schemas, and purposes.

Read the doc 789 wordsarchitecture/databases.md
Architectureupdated Dec 2025

Multi-Tenant Architecture

Campaign Brain uses a single-tenant deployment model where each customer gets their own isolated application instance.

Read the doc 292 wordsarchitecture/multi-tenant.md
Architectureupdated Dec 2025

Architecture Overview

Campaign Brain is a multi-tenant SaaS platform for political campaign management.

Read the doc 324 wordsarchitecture/overview.md
Service Guidesupdated Dec 2025

Campaign Brain Features

The main dashboard provides an overview of campaign activity:

Read the doc 171 wordscbapp/features.md
Service Guidesupdated Dec 2025

Campaign Brain App

The Campaign Brain App (cbapp) is the core application deployed for each tenant.

Read the doc 198 wordscbapp/index.md
Service Guidesupdated Dec 2025

Logo & Image Guide

This document explains how logos and images are used in Campaign Brain.

Read the doc 709 wordscbapp/logo-guide.md
Service Guidesupdated Dec 2025

Tenant Manager API Documentation

Base URL: http://localhost:32201/api or https://manager.nominate.ai/api

Read the doc 1,532 wordscbtenant/api.md
Service Guidesupdated Dec 2025

Tenant Deployment

This guide covers deploying new tenant instances.

Read the doc 369 wordscbtenant/deployment.md
Service Guidesupdated Dec 2025

Tenant Manager

The Tenant Manager (cbtenant) is the central orchestration system for Campaign Brain.

Read the doc 314 wordscbtenant/index.md
Service Guidesupdated Dec 2025

Tenant Manager Screenshots

Visual documentation of the Tenant Manager interface across different viewport sizes.

Read the doc 158 wordscbtenant/screenshots.md
Service Guidesupdated Dec 2025

Tenant Upgrade Runbook

This document describes how to upgrade tenant cbapp instances to the latest code, including running migrations and restarting services.

Read the doc 743 wordscbtenant/upgrade.md
Developmentupdated Dec 2025

Campaign Brain: Claude Code Agent Guide

Campaign Brain is built across four interconnected modules, each in its own GitHub repository. This guide establishes the rules of engagement for Claude Code agents working on any of these projects.

Read the doc 1,305 wordsdevelopment/claude-code-guide.md
Developmentupdated Dec 2025

Contributing

Guidelines for contributing to Campaign Brain.

Read the doc 349 wordsdevelopment/contributing.md
Developmentupdated Dec 2025

Nominate Logging Cheatsheet

All Nominate services log to journald for centralized, interleaved viewing.

Read the doc 1,004 wordsdevelopment/logging.md
Developmentupdated Dec 2025

Campaign Brain Style Guide

Visual design guidelines for Campaign Brain.

Read the doc 308 wordsdevelopment/style-guide.md
Getting Startedupdated Dec 2025

Configuration

The tenant manager uses SQLite for metadata storage:

Read the doc 159 wordsgetting-started/configuration.md
Getting Startedupdated Dec 2025

Installation

Create a .env file:

Read the doc 125 wordsgetting-started/installation.md
Getting Startedupdated Dec 2025

Quick Start

Get a tenant up and running in 5 minutes.

Read the doc 148 wordsgetting-started/quickstart.md
Guidesupdated Dec 2025

Data Conditioning Pipeline Design

Rather than sending raw CSV data directly from cbtenant to cbapp, implement a data conditioning pipeline that cleans, validates, deduplicates, and enriches data before database insertion. This approach:

Read the doc 2,047 wordsguides/data-conditioning.md
Guidesupdated Dec 2025

Documentation Sync Process

This guide describes how to keep the Campaign Brain documentation hub synchronized with all projects.

Read the doc 1,064 wordsguides/docs-sync.md
Guidesupdated Dec 2025

i360 Data Loading Guide

This document describes how to load i360-formatted voter data into CampaignBrain.

Read the doc 1,001 wordsguides/i360.md
Guidesupdated Dec 2025

Incident: Python 3.10 Compatibility & Missing Migrations

Production tenant APIs (ky04, mi20-clevenger) had two issues:

Read the doc 494 wordsguides/incident-2025-12-22-python-compat.md
Guidesupdated Dec 2025

AI-Directed Contact List Loader - Design Document

The List Loader enables campaign staff to upload CSV/Excel contact lists via the Tenant Manager and have AI automatically suggest field mappings to the cbapp Person schema.

Read the doc 1,388 wordsguides/list-loader.md
Guidesupdated Dec 2025

Release Hooks

Tag-specific deployment scripts that run during tenant upgrades.

Read the doc 550 wordsguides/release-hooks.md
Guidesupdated Dec 2025

Tenant Deployment Guide

Complete guide to deploying a new Campaign Brain tenant.

Read the doc 450 wordsguides/tenant-deployment.md
Guidesupdated Dec 2025

Troubleshooting

1. Service running: systemctl status {slug}-api

Read the doc 497 wordsguides/troubleshooting.md
Guidesupdated Dec 2025

Upgrading Tenants

Guide to upgrading tenant instances to new cbapp versions.

Read the doc 641 wordsguides/upgrading.md
Platformupdated Dec 2025

Integration Partners

Campaign Brain integrates with various platforms and services through the Workflow Engine. These partners provide specialized capabilities for campaign outreach and voter engagement.

Read the doc 194 wordspartners/index.md
Referenceupdated Dec 2025

Changelog

Types of changes:

Read the doc 214 wordsreference/changelog.md
Referenceupdated Dec 2025

Known Bugs & Issues

Track bugs found during development and deployment. Copy these to GitHub Issues when ready.

Read the doc 929 wordsreference/known-issues.md
Referenceupdated Dec 2025

Tenant Manager Development Phases

Development broken into 6 phases, focusing on backend database and API first as requested. Frontend comes later after core logic is solid.

Read the doc 1,478 wordsreference/roadmap.md
Developmentupdated Dec 2025

Campaign Brain Style Guide

This style guide establishes the visual identity and design standards for Campaign Brain, a political campaign CRM and workflow management platform. The design language draws from the brand's core imagery—the eagle representing strength…

Read the doc 1,683 wordsstyle-guide/campaign-brain-style-guide.md