A Robyn workspace with batteries included.

• uv for everything

  uv sync creates the virtualenv and installs from the committed uv.lock.

• Modular by design

  Every folder in app/modules is discovered at startup; each module owns its router, routes, models and services.

• OpenAPI + ReDoc

  Routes are registered with OpenAPI metadata, and ReDoc is served by the app.

• Docker included

  A slim, locked, --no-dev image and a Compose file for deployment.

• Ruff + pytest

  Linting, formatting and tests are configured in pyproject.toml.

• Debug ready

  F5 → Debug - DEV on port 40001, inside the container.

1. Click "Use this template" → "Create a new repository"
2. Clone your new repository and open the folder in VS Code
3. Accept "Reopen in Container" when prompted
4. Press F5 → "Debug - DEV" and open http://127.0.0.1:40001

Requirements: Docker running, VS Code and the Dev Containers extension.

.
├── .devcontainer/devcontainer.json   # Python 3.14 + uv, extensions, port 40001
├── app/
│   ├── api/__init__.py               # Robyn app + OpenAPI metadata
│   ├── extensions/                   # logger + routes loader
│   ├── modules/                      # hello_world, redoc, status
│   ├── constants.py                  # BASE_PATH
│   └── run.py                        # module discovery + entry point
├── Dockerfile
├── dockercompose.yml
├── pyproject.toml
└── uv.lock

BASE_PATH in app/constants.py controls the /app prefix. The app reads ROBYN_HOST, ROBYN_PORT, ROBYN_LOG_LEVEL, ROBYN_PROCESSES and ROBYN_WORKERS from the environment.

• Use this templateCreate a repository from the template
• Sourcegithub.com/thepaneb/base_robyn
• base_flaskThe same idea for a Flask workspace