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 Aug 22, 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 Aug 22, 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.1-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.1-cp314-cp314-manylinux_2_34_aarch64.whl (16.1 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.34+ ARM64

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

Uploaded CPython 3.14macOS 11.0+ ARM64

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

Uploaded CPython 3.14macOS 10.12+ x86-64

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

Uploaded CPython 3.13manylinux: glibc 2.34+ ARM64

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

Uploaded CPython 3.13macOS 11.0+ ARM64

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

Uploaded CPython 3.13macOS 10.12+ x86-64

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

Uploaded CPython 3.12manylinux: glibc 2.34+ ARM64

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

Uploaded CPython 3.12macOS 11.0+ ARM64

caddysnake-0.6.1-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.1-cp314-cp314-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.6.1-cp314-cp314-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 7b3f2cc96ab55d79b7886cf273262d6a7915e316ba85dac4bf879483ef8dbaff
MD5 2d22e5e6f48b3316c31807c7c3c503e6
BLAKE2b-256 e44dc1c9feea89f3bc845fe2e2b4e71324dc1c664e169aeae922012e61cd8f94

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.6.1-cp314-cp314-manylinux_2_34_aarch64.whl
Algorithm Hash digest
SHA256 9a2064091c10f756e72a402a572e5ab7fc66c1b8ad44762647ae307fe323e702
MD5 04845db70a14a3b1a41cfa3b6a1dcf2b
BLAKE2b-256 055ccd2c4aca977baf0a52985b366b164fd76e219f9ab2e86b1423bc29856c8a

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.6.1-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 ef16620ef0926ee7d420e26ee6c57487e28ed4cc8697ef518fbe356d45038f34
MD5 ed6bec76655138ca5a1f42499976bd96
BLAKE2b-256 25bd97407a47e1b4876d468393f5aa5b7f31b433b9320e70d2a64e4bbc487fe9

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.6.1-cp314-cp314-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 a79ace2bff7cf4a3e139aefc9ae2529e4ca38faef9b1f12707e4e86d82c54c3d
MD5 7250bd438c8c1375d565b300244e7f75
BLAKE2b-256 e267795cec3e126f151f11803ab4d7ed6b4f6b5b4aa3f785d64579b3a3d1f638

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.6.1-cp313-cp313-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 ec9ac4e5158cf5daf19a6e7fb184125cdce2675661ca133dd31c98792b241972
MD5 c89109f3ce71b67bbf86e505e6e8f3ac
BLAKE2b-256 b8dee1bb44012e6a276ffc6117bc632ac3d051563ded2145b2efb7f1ab3e339c

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.6.1-cp313-cp313-manylinux_2_34_aarch64.whl
Algorithm Hash digest
SHA256 505cd3ba62e889a59dcb48c128d5881eadf829788d28b7d5aeb0b8e323724091
MD5 83cd45af7b3c501f686810f045bada37
BLAKE2b-256 1118b717cbd0af512e0bb6b17eef079cb30228578a54330f531ae06b8d70c291

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.6.1-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 bcddb059585eff9e452efc3408725254adaf0bf4b1d6e14072afd28f4a5c2411
MD5 7cc70a4eebb18e15678115873458e6d2
BLAKE2b-256 be9f755a84d5656b9f7f59b70c3b38c2f1eb188a8ad27ca34204e70f0e31efa8

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.6.1-cp313-cp313-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 3cd66d453181b238a0ebfa913000ed9f1c65ab46d230ac3fb122d0933187e2c8
MD5 2ecdb5b47fa35fc564fa00d2d6214f45
BLAKE2b-256 abfa9def3c76d42c22e7552d81690a66b0357d82638fc3e1a557b12b791f7d73

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.6.1-cp312-cp312-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 0578f3b70152e2ca8a775c350794dbd8695c00f9ec14b1dd82fe3c57aa1ecfc6
MD5 b28e066baa57b816c06fa74fd1d3e3a6
BLAKE2b-256 a344b178557f4de35baf9751cfa998627083dcefb5dda212b8c2de53def8e8db

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.6.1-cp312-cp312-manylinux_2_34_aarch64.whl
Algorithm Hash digest
SHA256 9afe87bc63f2ec4b643a44198f003ff83b4e38eaaf1626f234abd8dad9088cea
MD5 02846604bb3ba0618c4ceb361e4f66d2
BLAKE2b-256 8b3fe8f34a64b82fe7f70ef2537afd2143409a3e8bbb42c4055fe0e2b0e6276d

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.6.1-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 18dd14ea22a685fa931f56a4a1bab9afaecf2d73c85e9b2cf746f77dedd235db
MD5 10066f93b703f5729a4167ed46d10f0a
BLAKE2b-256 a0f7bfa95e456d125a75cd0fe449610e66cb5b3f7a7076569df8bfdecaa8e6c3

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.6.1-cp312-cp312-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 d6a02566928d209f9d9311696ab076cfada7992e5ac69dbe4bef1d583d1f4708
MD5 a6c63a94b9f7df5008378b52271c7354
BLAKE2b-256 db680e849ba8a049e48b767ae34b4971ff07009f099d13f48d34c3911d52fd72

See more details on using hashes here.

Provenance

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

This release

0.6.1 This release

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