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
--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 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 Jul 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.5.13-cp314-cp314-manylinux_2_34_x86_64.whl (17.6 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.34+ x86-64

caddysnake-0.5.13-cp314-cp314-manylinux_2_34_aarch64.whl (16.0 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.34+ ARM64

caddysnake-0.5.13-cp314-cp314-macosx_11_0_arm64.whl (16.7 MB view details)

Uploaded CPython 3.14macOS 11.0+ ARM64

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

Uploaded CPython 3.14macOS 10.12+ x86-64

caddysnake-0.5.13-cp313-cp313-manylinux_2_34_x86_64.whl (17.6 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.34+ x86-64

caddysnake-0.5.13-cp313-cp313-manylinux_2_34_aarch64.whl (16.0 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.34+ ARM64

caddysnake-0.5.13-cp313-cp313-macosx_11_0_arm64.whl (16.7 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

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

Uploaded CPython 3.13macOS 10.12+ x86-64

caddysnake-0.5.13-cp312-cp312-manylinux_2_34_x86_64.whl (17.6 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.34+ x86-64

caddysnake-0.5.13-cp312-cp312-manylinux_2_34_aarch64.whl (16.0 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.34+ ARM64

caddysnake-0.5.13-cp312-cp312-macosx_11_0_arm64.whl (16.7 MB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

caddysnake-0.5.13-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.5.13-cp314-cp314-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for caddysnake-0.5.13-cp314-cp314-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 f24fff6f1d136a25d9983f332701c7a211c60245f70d4315dc3202411c03b47b
MD5 1e3de87d2fbeefa43d072a6b03addf24
BLAKE2b-256 915ab475d5e4c0860ac1d1007d52285a8cd9a8e37ccfeee0616b4c80983d73fa

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.5.13-cp314-cp314-manylinux_2_34_aarch64.whl
Algorithm Hash digest
SHA256 701c100fa2132c4a2bdbd90d71357534ccc6daa898d199e4c77fafb0814dbebe
MD5 21145d05bad38944354ab6af20bdbee8
BLAKE2b-256 1c68bf2e881096d59dfc045957121def5e79224e0188511f7365b51f4f9f0200

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.5.13-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 e29d89e3ab55bd20d1fba9156163c0eb3502953a3425049c36211a196f0edd8d
MD5 b4ab17b9681f473deeb9288f14c3722b
BLAKE2b-256 806b93dd29d8f6579104e67a0bb5423319ece144f1d515397db58d0f87001239

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.5.13-cp314-cp314-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 c8271e985f986b155e45ca4ee08f9c6d51fc1fa5dd9aab010f24f15a7f4dc93b
MD5 db530192e729accb256ad4e7f8d8b150
BLAKE2b-256 13926023ce9fa0ead14b9188adddb32e209a9d07b9b21377296d8b55a406348f

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.5.13-cp313-cp313-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 f831f5d6e9791fd8fadebdd831c79d532cc28d70ddac50d168bdeab22acf4832
MD5 dff367aa023ae15c1af29adf6b67a7be
BLAKE2b-256 c58c62d8c3d4bceef30f7efeb51bc194504906b6b6a702924fc161e7517b5daf

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.5.13-cp313-cp313-manylinux_2_34_aarch64.whl
Algorithm Hash digest
SHA256 81422e8491567eaff343e8fd59f18bf47815df0d33e9698153029f7eb1c3e9fe
MD5 b9e381d1cdd9da93ba6c1c0999ffff20
BLAKE2b-256 cb2124dfddbd2fd2013bafa28d2881e620245e209b2032b8bd297a5068879724

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.5.13-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 2c9d2b58806a4306b467585a79f2341ef5c4d05b6f0d4a7365f669814a313a32
MD5 66a4bbdb60b33e9ca41ad42715d60ee9
BLAKE2b-256 b1eae6cee26db61b4f7cddc8f34bc6f9f385f18fe723ff2b612a5949ccd6b3ba

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.5.13-cp313-cp313-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 5f9a7dad7e9d4727957da3cc3dce505129535158a0b47b7a093e938c697ff517
MD5 1106094dadb8584236efa22f0c40431a
BLAKE2b-256 f61e259dd3acc9f2504896cdf8073ac5322cbb1f5bb8322ca6cad36db15dd695

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.5.13-cp312-cp312-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 b54dfd354d0cb2ba7544a6fc153e40288388942cbcd4c8068c6393b06ab9b5aa
MD5 44bf116deb7a3203b6f7f3f8359ef22a
BLAKE2b-256 40ca1b4f38f15d5184e76d7721ad48951a9da2283a177e0d982b0d3378f2c517

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.5.13-cp312-cp312-manylinux_2_34_aarch64.whl
Algorithm Hash digest
SHA256 5f1581dff6293083f4ee50ce55a5e95cba125fd2f7b8ddc7c90b8405c32f5a30
MD5 8fe01e6e1a7e890566176e18c143997e
BLAKE2b-256 bf52223443e9eae962ad00a60a6a175afe4e3e64dab486111ccb0f8c02bb0c64

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.5.13-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 19c054090ca1f136283c712ae27b09d0bf1862678a38b59c3f8ae17e902a9cb6
MD5 ea4ffb7416a96065f78affe5198ad024
BLAKE2b-256 7e324aae128dbf06a2161d36f4f91b97f6bf9beedb6dd68874db087c9dbfa917

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for caddysnake-0.5.13-cp312-cp312-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 aa9c6a454c9ba34feafc5f15ad077afc5ee1dd884aae50467d380e943dab1b4b
MD5 87c3314912566493ca25a4b7929bd574
BLAKE2b-256 11b12d2940f71a6be3c2baa18a003f1c8b0c7f9a33033dc66d0af12f9747124b

See more details on using hashes here.

Provenance

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

0.6.0

12 files

This release

0.5.13 This release

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