Skip to content

System Design

Design Goals

  • Keep default installs lightweight by using extras.
  • Reuse converter code across CLI, API, and MCP surfaces.
  • Make generated Markdown deterministic enough for version control and review.
  • Support both local developer workflows and containerized HTTP services.

Architectural Pattern

The repository is not a microservice repository in packaging terms. It is a modular monolith with optional independently runnable FastAPI services. Docker Compose turns selected modules into service containers behind nginx, but the Python release remains unified.