teteffd / apps /api /README.md
Developer
WormGPT - production-grade AI chat platform
276ef31
|
Raw History Blame Contribute Delete
2.48 kB

WormGPT API

FastAPI service for the WormGPT platform.

Quick start

# 1. Create a virtualenv
python -m venv .venv
. .venv/bin/activate            # Linux / macOS
# .venv\Scripts\activate         # Windows PowerShell

# 2. Install
pip install -e ".[dev]"

# 3. Configure
cp ../../.env.example ../../.env
# edit ../../.env

# 4. Run
uvicorn app.main:app --reload --port 8000

Endpoints

  • GET /api/v1/health liveness
  • GET /api/v1/health/ready mongo + redis check
  • POST /api/v1/auth/register sign up (status = pending)
  • POST /api/v1/auth/login returns access + refresh
  • POST /api/v1/auth/refresh rotate access token
  • GET /api/v1/auth/me current user
  • GET /api/v1/models list enabled models
  • POST /api/v1/models (admin) create model
  • PATCH /api/v1/models/{id} (admin) update model
  • POST /api/v1/models/{id}/test ping the model
  • GET /api/v1/system-prompts/summary lightweight list (no content)
  • GET /api/v1/system-prompts (admin) full content
  • POST /api/v1/system-prompts (admin) create with content
  • GET /api/v1/chat/conversations list
  • POST /api/v1/chat/conversations create
  • POST /api/v1/chat/conversations/{id}/stream SSE chat
  • GET /api/v1/chat/conversations/{id} with messages
  • PATCH /api/v1/chat/conversations/{id}/messages/{mid} edit
  • POST /api/v1/chat/conversations/{id}/messages/{mid}/react
  • GET /api/v1/chat/folders / POST /api/v1/chat/folders
  • GET /api/v1/memory / POST /api/v1/memory
  • GET /api/v1/notifications mark read
  • GET /api/v1/search?q=...&kinds=conversation,message,model,canvas,memory,user
  • GET /api/v1/canvas / POST /api/v1/canvas
  • GET /api/v1/canvas/{id}/versions
  • POST /api/v1/canvas/{id}/restore/{v}
  • POST /api/v1/research/run one-shot research
  • POST /api/v1/research/stream streaming research (SSE)
  • POST /api/v1/web/search web search
  • GET /api/v1/web/fetch?url=... fetch + extract
  • GET /api/v1/admin/stats (admin)
  • GET /api/v1/admin/users (admin)
  • POST /api/v1/admin/users/{id}/approve|reject
  • GET /api/v1/admin/audit-logs (admin)
  • GET /api/v1/developer/models (admin) all models
  • POST /api/v1/developer/models/{id}/reveal (superadmin)

OpenAPI docs at http://localhost:8000/api/docs.