Files
monlet/server

Monlet Server

Placeholder for the Python/FastAPI server.

Planned stack:

  • Python 3.14;
  • uv;
  • FastAPI;
  • Pydantic;
  • SQLAlchemy 2.x style;
  • Alembic;
  • PostgreSQL;
  • httpx for outbound notifier calls;
  • structured logging;
  • Prometheus metrics;
  • Docker image.

No server core logic is implemented in Stage 0.

Planned Commands

UV_PROJECT_ENVIRONMENT=.venv UV_CACHE_DIR=../.cache/uv uv sync
UV_PROJECT_ENVIRONMENT=.venv UV_CACHE_DIR=../.cache/uv uv run fastapi dev monlet_server/main.py

Do not install Python packages globally on the host. Docker builds install server dependencies inside the image; local development uses server/.venv and repo-local .cache/uv.