Trace every request. Run every service.

One operating atlas for the Kibegi Go API, asynchronous AI indexer, and confirmation-safe FastMCP agent gateway.

System boundaries

Three services, one dependable contract.

01 / PUBLIC CORE

Go API

Owns public routing, JWT validation, PostgreSQL writes, Redis coordination, MinIO object access, and domain authorization.

Explore API routes →

02 / PRIVATE WORKER

AI Indexer

Extracts documents, creates chunks, records jobs, retries stale work, and adds optional embeddings without delaying uploads.

Inspect the pipeline →

03 / AGENT SURFACE

FastMCP Gateway

Offers typed tools and a guarded generic API request path while forwarding the end-user JWT to Go for authorization.

Open the tool atlas →

Preserved API surface

Every domain stays on its own rail.

The Go service preserves the `/api/v1/` contract while domain packages own their repository rules, authorization, and cache invalidation.

View full reference ↗

01/api/v1/auth/
Identity & profiles

02/api/v1/classes/
Classes & members

03/api/v1/uploads/
Files & object storage

04/api/v1/schedule/
Calendars & feeds

05/api/v1/channel/
Broadcast channels

06/api/v1/ai/
AI state & processing

07/api/v1/search/
Search & history

08/api/v1/sms/
Wallets & delivery

Upload to retrieval

Index content without making uploads wait.

Go commits the upload and triggers the indexer asynchronously through a private service token.

Redis locks prevent duplicate workers while PostgreSQL keeps job state and chunks durable.

Optional embeddings enrich retrieval, but extraction remains useful if a provider is unavailable.

Read the indexer runbook →

First deployment

Build, validate, then expose the edges.

# verify the Go service
GOTOOLCHAIN=local go test ./...
GOTOOLCHAIN=local go build -o bin/kibegi-api ./cmd/kibegi-api/

# start private AI indexing
cd services/ai-indexer && uvicorn app.main:app --port 8090

# start the FastMCP gateway
cd ../kibegi-agent && uvicorn app.main:app --port 8091