Matrix Bot Directory

Matrix bot directory POC.

Run

docker compose up --build

• http://localhost:5173 — frontend
• http://localhost:8000/docs — API docs

The API runs migrations and seeds the database with Ada.

Stop the services:

docker compose down

Reset the local database:

docker compose down -v

API

GET  /api/health
GET  /api/projects/
GET  /api/projects/{project_id}
POST /api/projects/
PATCH /api/projects/{project_id}
DELETE /api/projects/{project_id}

Project IDs are UUIDs.

Migrations

Migrations are in backend/db/migrations and use Pelican.

cd backend
export DATABASE_URL='postgresql+psycopg://matrix:matrix@localhost:5432/matrix_directory'
pelican status
pelican up
pelican down