lattice-meetbot-admin

Mountable FastAPI admin router for lattice-meetbot captures.

Installation

pip install lattice-meetbot-admin

With dev server support:

pip install 'lattice-meetbot-admin[server]'

Optional extras for v0.2 features:

# Background workers (rq + redis) -- required for /webhooks/capture-complete + worker CLI
pip install 'lattice-meetbot-admin[queue]'

# Chat surface (anthropic SDK) -- required if you wire a real BrainClient that proxies to Claude
pip install 'lattice-meetbot-admin[chat]'

# All-in-one
pip install 'lattice-meetbot-admin[server,queue,chat]'

Quick Start

Mount into a FastAPI host

from fastapi import FastAPI
from lattice_meetbot_admin import create_router, MeetbotAdminConfig

config = MeetbotAdminConfig(
    db_url="sqlite:///./meetbot_admin.db",
    # auth_dependency=require_admin_auth,  # optional: your FastAPI auth callable
)

app = FastAPI()
app.include_router(create_router(config), prefix="/api/meetbot-admin")

Then hit http://localhost:8000/api/meetbot-admin/health to confirm it's live.

Dev server (standalone)

lattice-meetbot-admin dev-server --db-url sqlite:///./meetbot_admin.db
# API at http://127.0.0.1:5557/api/meetbot-admin/docs

Architecture

lattice-meetbot-admin is a constructor-DI package -- no global state. Pass your config once at mount time:

• MeetbotAdminConfig -- Pydantic v2 settings model (env-var overrides via MEETBOT_ADMIN_* prefix)
• MeetbotAdminRepo -- typing.Protocol; implement against your storage backend or use the bundled SqliteMeetbotAdminRepo
• create_router(config, repo=...) -- returns an APIRouter; mount under any prefix
• create_admin_app(config, repo=...) -- returns a FastAPI sub-application for app.mount()

REST API

Core (v0.1)

v0.2 (Phase 1)

All v0.2 routes are gated behind feature flags + auth (same auth_dependency as core routes). A route returns 503 when its feature flag is off or its required collaborator (BrainClient, TaskQueue, ffmpeg) is missing.

Multi-tenant scope: every list/search/chat/webhook surface accepts owner_user_id and threads it into repo filters, BrainClient.retrieve scope, and TaskQueue job kwargs.

Configuration (v0.2)

MeetbotAdminConfig adds the following fields on top of v0.1:

Env-var loading uses the MEETBOT_ADMIN_* prefix (e.g. MEETBOT_ADMIN_ENABLE_CHAT=true).

Worker CLI (v0.2)

Background jobs (post-capture pipeline, clip render, etc.) run via rq. Start a worker with:

lattice-meetbot-admin worker --redis-url redis://localhost:6379/0 --queue meetbot

Optional --owner-user-id scopes the worker to a single tenant (useful for per-tenant capacity isolation).

Migrations

lattice-meetbot-admin migrate --db-url sqlite:///./meetbot_admin.db

Alembic 0002 (shipped in v0.2) adds the FTS5 segments_fts shadow table, capture_events, and the voicenotes.owner_user_id column.

Deferred (v0.3+)

• Worker-side owner_user_id enforcement (v0.2 carries the id end-to-end; worker filtering is not yet wired).

License

Apache-2.0. Author: CodeWarrior4Life.