caddysnake CLI

PyPI

The caddysnake package is available on PyPI and provides a CLI to serve Python WSGI/ASGI/ESGI applications powered by Caddy.

Install

pip install caddysnake

Available for Python 3.12 through 3.14 on Linux and macOS (x86_64 and ARM64).

Usage

# Start a WSGI server
caddysnake --server-type wsgi --app main:app

# Start an ASGI server
caddysnake --server-type asgi --app main:app

# Start an ESGI server
caddysnake --server-type esgi --app main:application

CLI Options

Python-handler flags mirror the Caddyfile python block. Extra flags cover listen address, HTTPS, and static files.

Flag Short Description Default
--server-type -t Required. Type of Python app: wsgi, asgi, or esgi —
--app -a Required. Python module and app variable (e.g. main:app) —
--domain -d Domain name for HTTPS with automatic certificates —
--listen -l Custom listen address :9080
--workers -w Number of worker processes (0 = CPU count) 0
--max-dynamic-apps Max distinct dynamic Python apps 128
--python-path Path to the Python interpreter —
--working-dir Working directory for the Python app —
--venv Path to a Python virtual environment —
--env-file Dotenv file for worker env (repeatable) —
--env-var Inline worker env var NAME=VALUE (repeatable) —
--start-timeout Worker readiness wait (120s default; use =-1 or forever for indefinite) 120s
--runtime WSGI: sync|gevent; ESGI: gevent; ASGI: native|uvloop per interface
--lifespan ASGI lifespan events (on|off) off
--static-path Path to a static files directory —
--static-route Route prefix for static files /static
--debug Enable debug logging false
--access-logs Enable access logs false
--autoreload Watch .py files and reload on changes false

How it works

This package is built with maturin and distributed as platform-specific wheel files. Each wheel bundles a pre-compiled Caddy binary with the caddy-snake plugin (caddysnake-cli). The Python CLI wrapper (caddysnake_cli.py) uses click to parse arguments and then executes the bundled Caddy binary with os.execv.

The package is built and published automatically on tagged releases by the python-build.yml GitHub Actions workflow.

Full Documentation

See https://caddy-snake.readthedocs.io for complete documentation, including:

Project links

Data verified by PyPI on Jul 27, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.6.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for mliezun from gravatar.com mliezun

Credits

Author: Miguel Liezun

GitHub Statistics

Data verified by PyPI on Jul 27, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License

Requires

Python >=3.12

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

caddysnake-0.6.0-cp314-cp314-manylinux_2_34_x86_64.whl (17.7 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.34+ x86-64

caddysnake-0.6.0-cp314-cp314-manylinux_2_34_aarch64.whl (16.1 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.34+ ARM64

caddysnake-0.6.0-cp314-cp314-macosx_11_0_arm64.whl (16.8 MB view details)

Uploaded CPython 3.14macOS 11.0+ ARM64

caddysnake-0.6.0-cp314-cp314-macosx_10_12_x86_64.whl (18.0 MB view details)

Uploaded CPython 3.14macOS 10.12+ x86-64

caddysnake-0.6.0-cp313-cp313-manylinux_2_34_x86_64.whl (17.7 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.34+ x86-64

caddysnake-0.6.0-cp313-cp313-manylinux_2_34_aarch64.whl (16.1 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.34+ ARM64

caddysnake-0.6.0-cp313-cp313-macosx_11_0_arm64.whl (16.8 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

caddysnake-0.6.0-cp313-cp313-macosx_10_12_x86_64.whl (18.0 MB view details)

Uploaded CPython 3.13macOS 10.12+ x86-64

caddysnake-0.6.0-cp312-cp312-manylinux_2_34_x86_64.whl (17.7 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.34+ x86-64

caddysnake-0.6.0-cp312-cp312-manylinux_2_34_aarch64.whl (16.1 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.34+ ARM64

caddysnake-0.6.0-cp312-cp312-macosx_11_0_arm64.whl (16.8 MB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

caddysnake-0.6.0-cp312-cp312-macosx_10_12_x86_64.whl (18.0 MB view details)

Uploaded CPython 3.12macOS 10.12+ x86-64

File details

Details for the file caddysnake-0.6.0-cp314-cp314-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.0-cp314-cp314-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 802ffb84323a84a564c2c3b0d9363ffa93c8e7b6192d5475fd9c4a16ca3f11b3
MD5 87fd9521149f3705d0a4503318b0eae0
BLAKE2b-256 f34c4fc13b94f21c8e812c5396ab0a84ac6a0c2eed9af8be51b0943e05373094

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.0-cp314-cp314-manylinux_2_34_x86_64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.6.0-cp314-cp314-manylinux_2_34_aarch64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.0-cp314-cp314-manylinux_2_34_aarch64.whl
Algorithm Hash digest
SHA256 5413b8fbfa00098e17f14139cb53e1c1abb3a626802e8665c2b23c5b3b24fce5
MD5 8c05d5290f6fedc282225e4d1f3d2b45
BLAKE2b-256 7d9146e6fa090d0d03b1bcaafaa5a9edd642024c058cce5bb8074753c8d99f76

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.0-cp314-cp314-manylinux_2_34_aarch64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.6.0-cp314-cp314-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.0-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 8469c44fce2e25e7f7aead21f68ed62918c01c8ab58354cd302c0c12817897d6
MD5 38c54c0892afa9154fcf11a057b8154d
BLAKE2b-256 351955aa2ca6d3e474162b55ffaec704a0828102bc3bb2e10f107a25ae8018b9

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.0-cp314-cp314-macosx_11_0_arm64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.6.0-cp314-cp314-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.0-cp314-cp314-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 f5bb384f0a6817ac0f04b61535c8e2967f7dc3c9ad33da542a8cef12796a23ab
MD5 01b566e84e8b9840085c3877e1a3bbbe
BLAKE2b-256 1a1be4a476aeb2d0b529bd79d259b334552e26800466c9a8832a7b758e03cfca

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.0-cp314-cp314-macosx_10_12_x86_64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.6.0-cp313-cp313-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.0-cp313-cp313-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 595c7543fad2a8bf40d605a7f03f37a26e5c429273627cb48a13f41342da3767
MD5 9bff95cc57fe6732d33646173af011c0
BLAKE2b-256 e05ecf916376dc0ab30e75753785a7944e76b195b1cdc71fd7f68023ee396a26

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.0-cp313-cp313-manylinux_2_34_x86_64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.6.0-cp313-cp313-manylinux_2_34_aarch64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.0-cp313-cp313-manylinux_2_34_aarch64.whl
Algorithm Hash digest
SHA256 805386645ab3a8252d7480d3abb19f972c4a983bb18ad5aaf991be86e7fee0cc
MD5 ce3790294fc4c63e50bbc1bb3d0c5576
BLAKE2b-256 7080108c376728ac58524e4d256536c17690b07708767ab037d8f7b3c0622d95

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.0-cp313-cp313-manylinux_2_34_aarch64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.6.0-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.0-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 fc922f55d7b633201c8bd1bf57243e92a64fc52d0783104cc0eb2d2ec9906701
MD5 046be1eced69fd3724dd5b3d3b3b097b
BLAKE2b-256 36729d674323e6443fc906f1ed91dbc9c2a984b5090c90cae41a6db34b354132

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.0-cp313-cp313-macosx_11_0_arm64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.6.0-cp313-cp313-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.0-cp313-cp313-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 c71f7f31685122dce8b8e364572fc9806799a50ccd177d701364bf091a8c4956
MD5 f536c3e2edebd3ae838bb6dde71b7412
BLAKE2b-256 f2c24b978c043add5435c7024bc64069ce257952889b3ae940f6a28187edcc32

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.0-cp313-cp313-macosx_10_12_x86_64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.6.0-cp312-cp312-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.0-cp312-cp312-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 c380a6bc2e91f64180827518234d241740c07e745c29d8b5979ee11c9e8d3851
MD5 b978305e1d341697824c506a31c651ba
BLAKE2b-256 ad44b88251658d32d19930a046537a8fc7fc3c700467fa831f883e67f69754ba

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.0-cp312-cp312-manylinux_2_34_x86_64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.6.0-cp312-cp312-manylinux_2_34_aarch64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.0-cp312-cp312-manylinux_2_34_aarch64.whl
Algorithm Hash digest
SHA256 d140d98416e78a3f302ea77d4f67fcdbcc126ea01330112f40aa75c867a2eaa8
MD5 eb68eb30acd8c3a3c2396945999c901e
BLAKE2b-256 8b7230584be023670790efcef7db7daff0ff77ea4d57ddb6c165173a0e917fe1

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.0-cp312-cp312-manylinux_2_34_aarch64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.6.0-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 b0690eedb85fc278346bd74beea1a84070eb7f9f4f2e9794d4a204614d1fde8d
MD5 86c1e8e407f905b53922646e318bfb14
BLAKE2b-256 3525f904ff0f09a92f480813d741107a822f99c9ffe3b2689f33c47f32659f5d

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.0-cp312-cp312-macosx_11_0_arm64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file caddysnake-0.6.0-cp312-cp312-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.0-cp312-cp312-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 7b27dbf4cfbc6da0ae160df6d7795cd29e9617021a5274f3cb98cbb3f15b21fb
MD5 03a6119cf496a2b1f0f674c45e4de56e
BLAKE2b-256 a6c18f6bd66f01b59832e64abc19a8ff87c211f40784be1ce0207c84df4636c0

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.0-cp312-cp312-macosx_10_12_x86_64.whl:

Publisher: python-build.yml on mliezun/caddy-snake

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.6.2

12 files

0.6.1

12 files

This release

0.6.0 This release

12 files

0.5.13

12 files

0.5.12

12 files

0.5.11

12 files

0.5.10

12 files

0.5.9

12 files

0.5.8

12 files

0.5.4

3 files

0.5.3

3 files

0.5.2

3 files

0.5.1

9 files

0.5.0

6 files

Pre-release

0.4.2a0

6 files

0.4.1

6 files

0.4.0

6 files

0.3.0

10 files

0.2.2

10 files

0.2.1

5 files

0.2.0

4 files

0.1.10

4 files

0.1.8

4 files

0.1.7

4 files

0.1.6

4 files

0.1.5

4 files

0.1.4

4 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page