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
--request-body-max-size Maximum HTTP request body size (e.g. 1KiB, 2GB) unlimited
--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 Sep 2, 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:
Latest release

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 Sep 2, 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.2-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.2-cp314-cp314-manylinux_2_34_aarch64.whl (16.1 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.34+ ARM64

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

Uploaded CPython 3.14macOS 11.0+ ARM64

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

Uploaded CPython 3.14macOS 10.12+ x86-64

caddysnake-0.6.2-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.2-cp313-cp313-manylinux_2_34_aarch64.whl (16.1 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.34+ ARM64

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

Uploaded CPython 3.13macOS 11.0+ ARM64

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

Uploaded CPython 3.13macOS 10.12+ x86-64

caddysnake-0.6.2-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.2-cp312-cp312-manylinux_2_34_aarch64.whl (16.1 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.34+ ARM64

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

Uploaded CPython 3.12macOS 11.0+ ARM64

caddysnake-0.6.2-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.2-cp314-cp314-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.2-cp314-cp314-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 47c99f1918c1810afcf770ad14cc5f3f45735585d172c74fb13f14c12268d0bb
MD5 de6c96eb57bedc98b1e4488d3079ab01
BLAKE2b-256 e28596065ffa827f8bb402045e6d6b40eff705191126bf37cf01a9e83f0789b4

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.2-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.2-cp314-cp314-manylinux_2_34_aarch64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.2-cp314-cp314-manylinux_2_34_aarch64.whl
Algorithm Hash digest
SHA256 54e035b760181f934edef085fbb39f93ce1c1159d091c1e0afdfc2d234c0bc9b
MD5 8d31dfa28f01d0dd510961f965d3cf8f
BLAKE2b-256 d39574c782fa901693c2e2285ead4b4f2e2368aa915146ca5f3f7face2173c7b

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.2-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.2-cp314-cp314-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.2-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 614106beac788e9c2ba4c98ed7609961bedec43f1f5af40cc0a14a4ecbaac5fe
MD5 119882df8115f5cc5ae99977417ef249
BLAKE2b-256 04cb5cb89f911dbded6c6b3ee25501bc3c258145b5e6522caa108380ae121ac0

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.2-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.2-cp314-cp314-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.2-cp314-cp314-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 71f30efbcbaed911610f023db6b8eb718160a7ac613d89ed21a680820f3274c3
MD5 800379efd4dff2a17d99418b59b1b05c
BLAKE2b-256 5e1b2b9f29e1025e98fac7b395e43c81e8ef3b0ff8bd75b149fd9abef2eac345

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.2-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.2-cp313-cp313-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.2-cp313-cp313-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 76d646201d59f77a7ac837a448cf3d7f492a9357af7ff78e207f638d0b40e620
MD5 4b449a0325a7d410c03f1aa291258d2e
BLAKE2b-256 ccfef956a4704dd87bce63a415f018708a9353438dd272597afca4f48333dde3

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.2-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.2-cp313-cp313-manylinux_2_34_aarch64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.2-cp313-cp313-manylinux_2_34_aarch64.whl
Algorithm Hash digest
SHA256 4b9c8f791e17de84979bb93e055e173ff51854e524b8e140057e6cbcf7d6c4c3
MD5 49d613632bc3a1775859fe0120ba6f1e
BLAKE2b-256 1b8ebc31834bef1660849fe343088a62badfe136cb760e75684c86e27b916ec8

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.2-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.2-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.2-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 6573f092fa5f88b17313ce3ccfa9368ed01eedca3452b58e771390bfe6be8511
MD5 015cc31f47ebda016ba2b230469e9a07
BLAKE2b-256 eb08081453139024e38892446f6759355678e273e30709faae592c3b29bd487e

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.2-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.2-cp313-cp313-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.2-cp313-cp313-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 fcae2ad442f157640a51fde5a5546543b7d3d62179e1c8ad365289b89913749e
MD5 6b70ac74b62963a435aaa99aa5cac29e
BLAKE2b-256 cfc50f25e8c17decee0b95726829bb060ee2efe37cae0c005ba644826e64cd46

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.2-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.2-cp312-cp312-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.2-cp312-cp312-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 e2002b33d754d2c4db69a2019a7a1e7f772e1e3acc56e38b40613ccf94e054f7
MD5 792d09469f2125eddadfab17b602b874
BLAKE2b-256 22b907ce88a1485614c0372ce63b38f8e5ac39a340da98fb114ab9ec6b440563

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.2-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.2-cp312-cp312-manylinux_2_34_aarch64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.2-cp312-cp312-manylinux_2_34_aarch64.whl
Algorithm Hash digest
SHA256 bae879e4367734a7e3e42876a9a319aebfe76e649947e6854d5507b23bd11ffd
MD5 c75aa438ecce20d4601d84828c438c94
BLAKE2b-256 61634071b9cce824ec9d285c001dad7978cf96947b0fbbd491a60289be13b1fc

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.2-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.2-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.2-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 dc1303379bc73a911f744a815a55d4315fe370312eff7b118534e39c5b2652e6
MD5 a641b1f9b0834a2695cbab1db5fdf45f
BLAKE2b-256 e6fa5d75e56c56193ded7662a4027bb40a2b6ab3d8424618a4af6911bf5c6fd5

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.2-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.2-cp312-cp312-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.2-cp312-cp312-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 ae75912fc038b97a1b03593c15d5c880ea663428a56ad696cb42613e215c8810
MD5 e0a041a59c09f0dd26fed176ce8b33da
BLAKE2b-256 d9561191dd3e84af7e32ae7d791ea9a09fb9cf27bc47147cd63cb6765b7677c3

See more details on using hashes here.

Provenance

The following attestation bundles were made for caddysnake-0.6.2-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

This release

0.6.2 This release

12 files

0.6.1

12 files

0.6.0

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