PyPI · #1144 most downloaded on PyPI

granian

2.8.411M downloads/moemmett-framework/granian ↗New releases in your daily digest, changelog included.

A Rust HTTP server for Python applications

Last release 4 days ago
30 Sep 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
60 releases · first in 2022

Release timeline

60 releases since 2022

20222023202420252026

20222026

One column per quarter.

Releases

2.8.430 Sept 2026
Fix ASGI query-string encoding in access log
Patch release

Changes since 2.8.3:

Fix ASGI query-string encoding in access log

Fix IPv6 formatting in server log

Notify ASGI/RSGI apps of client disconnection on HTTP/2 stream reset

Avoid to raise errors in ASGI websockets' send calls

Bump dependencies
Open source →
2.8.314 Sept 2026
Notify ASGI/RSGI apps of client disconnection on HTTP/2 stream close
Patch release

Changes since 2.8.2:

Notify ASGI/RSGI apps of client disconnection on HTTP/2 stream close

Bump dependencies
Open source →

Patch release

Changes since 2.8.1:

Fix a regression bug causing issues with multiprocessing and fork_server method
Fix a lost-wakeup race in workers shutdown
Set wsgi.input_terminated in WSGI environ
- This fixes an issue with Werkzeug and chunked requests
Bump dependencies

Open source →

2.8.15 Aug 2026

Fix a performance regression on ASGI websockets

Patch release

Changes since 2.8.0:

Fix a performance regression on ASGI websockets
Fix PyFutureAwaitable Python interface
Enhance RSGI ws transport close strategy
Relax several atomic operations ordering

Open source →

2.8.03 Aug 2026

Add header atom to access log format (#829 by @nitrag)

What's Changed

New features

Add header atom to access log format (#829 by @nitrag)

Changes

BREAKING prioritize request's scope over OS env when building WSGI environ dict (#879 by @Barsoomx)
- This means conflicting keys won't override WSGI request data anymore
BREAKING TCP handshake errors are now logged under debug severity
Add Python 3.15 support
Drop free-threaded Python 3.13 support
Bump PyO3 to 0.29 (#820 by @tobiasge)
Bump dependencies

Enhancements

BREAKING Refactor socket sharing on Linux
- Granian on Linux now requires kernel >= 5.14 and net.ipv4.tcp_migrate_req sysctl option enabled when using multiple workers and respawn features
BREAKING Implement (non-configurable) backpressure over streamed/iterable responses in ASGI and WSGI protocols
- This trades a bit of throughput (mostly unnoticeable) for lower memory usage
Refactor workers main loop and shutdown process

Fixes

Fix several bugs on shutdown process (thanks @Malkiz223)
Fix a shared socket bug on free-threaded Python causing crashes on workers respawn

Open source →

2.7.93 Jul 2026

Fix a bug in the blocking threadpool scheduler heuristics causing starving/underscaling with WSGI protocol and long-running requests

Patch release

Changes since 2.7.8:

Fix a bug in the blocking threadpool scheduler heuristics causing starving/underscaling with WSGI protocol and long-running requests
Bump dependencies

Open source →

2.7.830 Jun 2026

Switch ASGI websockets teardown to optimistic locking to further avoid blocking Python's event-loop

Patch release

Changes since 2.7.7:

Switch ASGI websockets teardown to optimistic locking to further avoid blocking Python's event-loop
Bump dependencies

Open source →

2.7.723 Jun 2026

Fix a bug in ASGI protocol websockets teardown leading to Python's event-loop blocking

Patch release

Changes since 2.7.6:

Fix a bug in ASGI protocol websockets teardown leading to Python's event-loop blocking
Fix a memory leak in async applications calls

Open source →

2.7.610 Jun 2026

Fix a logical bug in workers shutdown flow leading to kill timeout not being respected

Patch release

Changes since 2.7.5:

Fix a logical bug in workers shutdown flow leading to kill timeout not being respected
Add more log info during shutdown process:
- Worker completed shutdown
- Shutdown process completed
Bump dependencies

Open source →

2.7.528 May 2026

Fix a bug in IPC implementation causing crashes on shutdown (#847 by @askedrelic)

Patch release

Changes since 2.7.4:

Fix a bug in IPC implementation causing crashes on shutdown (#847 by @askedrelic)
Enhance proxy helpers implementation
Bump dependencies

Open source →

2.7.423 Apr 2026

Fix a bug in ASGI protocol leading to panics on malformed websocket subprotocol headers

Patch release

Changes since 2.7.3:

Fix a bug in ASGI protocol leading to panics on malformed websocket subprotocol headers
Fix a bug in RSGI and WSGI protocols leading to panics on malformed response headers
Bump dependencies

Open source →

2.7.37 Apr 2026

Fix a bug in ASGI protocol preventing to receive websocket disconnection messages before accept

Patch release

Changes since 2.7.2:

Fix a bug in ASGI protocol preventing to receive websocket disconnection messages before accept
Bump dependencies

Open source →

2.7.224 Feb 2026

Review ASGI websockets' rejection flow

Patch release

Changes since 2.7.1:

Review ASGI websockets' rejection flow
- This should fix an hang issue with Django channels
Fix ASGI websocket scope suprotocols split (#817 by @JaeHyuckSa)
Fix Content-Type header in metrics endpoint (#808 by @IngmarStein)
Bump dependencies

Open source →

2.7.18 Feb 2026

Fix websockets' handles cleanup on shutdown

Patch release

Changes since 2.7.0:

Fix websockets' handles cleanup on shutdown
- This should fix an occasional runtime thread panic with the message Cannot drop pointer into Python heap without the thread being attached
Fix a bug in the ASGI protocol preventing apps to receive the websocket.disconnect event after server-initiated close (#801 by @JaeHyuckSa)
- This should fix some long-standing issues with Django channels
Review some lock holding strategy in PyFutureAwaitable callback dispatch (#802 by @ColemanDunn)
Bump dependencies

Open source →

2.7.02 Feb 2026

Add prometheus metrics export (based on @butlerx preliminary work)

What's Changed

New features

Add prometheus metrics export (based on @butlerx preliminary work)
Add support for ASGI websocket denial response extension (#771 by @JaeHyuckSa)
Add static files rewrite support for directory listings (#784 by @tobiasge)
Add support for multiple static paths

Changes

Lowered --blocking-threads-idle-timeout minimum accepted value to 5 seconds
Bump dependencies

Enhancements

Refactor blocking thread-pool resize strategy
Review auto runtime mode option

Fixes

Bump minimum version of click dependency

Open source →

2.6.016 Nov 2025

Add winloop support (#682 by @jpagh)

What's Changed

New features

Add winloop support (#682 by @jpagh)
Allow to set UDS file permissions (#697 by @apapsch)
Add TLSv1.2 support (#665 by @dpetzold)
Bump RSGI spec to 1.6
- Add response_file_range protocol interface (#159 by @myers)
Add --rss-samples option

Changes

Drop Python 3.9 support
Drop PyPy 3.9 and 3.10 support
Promote Python 3.14 support to stable
Promote UDS support to stable
Avoid to automatically set workers' kill timeout with reloader enabled (#696 by @Sube-py)
Lowered --rss-sample-interval minimum accepted value to 1 second
Bump PyO3 to 0.27
Bump mimalloc to v3
Bump dependencies

Enhancements

Refactored workers Rust traits
Add auto runtime mode option
Support non-ASCII file names in static files
Review workers' signals handling on Windows and async protocols

Fixes

Avoid panics on exceeding ASGI messages
Fix socket descriptor destruction on embedded server

Open source →

2.5.75 Nov 2025

Fix a Python 3.9 compatibility issue with utils.proxies module

Patch release

Changes since 2.5.6:

Fix a Python 3.9 compatibility issue with utils.proxies module

Open source →

2.5.629 Oct 2025

Fix a bug on WSGI protocol causing wrong PATH_INFO values in environ when --url-path-prefix used

Patch release

Changes since 2.5.5:

Fix a bug on WSGI protocol causing wrong PATH_INFO values in environ when --url-path-prefix used

Open source →

2.5.57 Oct 2025

Fallback to spawn multiprocessing start method when the default is not compatible

Patch release

Changes since 2.5.4:

Fallback to spawn multiprocessing start method when the default is not compatible
- This fixes a bug preventing Granian to start on Unix systems running Python 3.14 with forkserver spawn method

Open source →

2.5.311 Sept 2025

Fix Cookie header concatenation on WSGI protocol under HTTP/2

Patch release

Changes since 2.5.2:

Fix Cookie header concatenation on WSGI protocol under HTTP/2
Fix a regression bug causing wrong request datetimes in access log

Open source →

2.5.22 Sept 2025

Add __all__ definition to package (#671 by @anuraaga)

Patch release

Changes since 2.5.1:

Add __all__ definition to package (#671 by @anuraaga)
Use monotonic time for deltas (#672 by @kikones34)
Bump dependencies

Open source →

2.5.030 Jul 2025

Human-readable CLI duration arguments (#622 by @3ok)

What's Changed

New features

Human-readable CLI duration arguments (#622 by @3ok)
- This allows CLI arguments like --workers-lifetime 6h
Workers memory usage limiter (--workers-max-rss option)
Unix Domain Socket support (experimental)

Changes

Massively refactored workers Rust code
Dotfiles now won't override pre-defined environment variables
- The reload of such files is still effective, it will simply skip pre-existing variables
Bump dependencies

Enhancements

Allow to disable static files cache headers (with --static-path-expires 0)
Minor additional interpreter detachments in free-threaded Python
Use of biased tokio::select

Fixes

Embed server hooks ordering
Respect code and reason values in ASGI websocket close messages

Open source →

2.4.028 Jun 2025

Startup, shutdown and reload hooks support (#584 by @adhami3310)

What's Changed

New features

Startup, shutdown and reload hooks support (#584 by @adhami3310)
Dotenv files loading support
Working directory option
Proxies' forwarded headers wrappers

Changes

Bump dependencies
Add (experimental) Python 3.14 support
Gate jemalloc allocator behind a feature flag

Enhancements

Disable connections keepalive on shutdown signal
- This should allow Granian to successfully shutdown/reload even in presence of keepalived connections
Improve descriptions of ASGI flow errors

Fixes

Embed server reload

Open source →

2.3.414 Jun 2025

Fix a bug in ASGI protocol with Server-Sent events preventing response headers from being sent before first message

Patch release

Changes since 2.3.3:

Fix a bug in ASGI protocol with Server-Sent events preventing response headers from being sent before first message

Open source →

2.3.22 Jun 2025

Fix an ASGI flow error on websockets occurring with applications calling receive before sending the accept message (thanks @jthorniley)

Patch release

Changes since 2.3.1:

Fix an ASGI flow error on websockets occurring with applications calling receive before sending the accept message (thanks @jthorniley)
- This should fix a long-running issue with Django channels and Granian erroneously raising ASGI Flow Error under some circumstances

Open source →

2.3.120 May 2025

Fix a bug on TCP accept loop causing workers to stop accepting new requests under some circumstances (thanks @nggit)

Patch release

Changes since 2.3.0:

Fix a bug on TCP accept loop causing workers to stop accepting new requests under some circumstances (thanks @nggit)
Enhance ASGI websocket disconnection handling (thanks @condemil)

Open source →

2.2.67 May 2025

Avoid to raise RuntimeError on RSGI headers methods when decoding fails

Patch release

Changes since 2.2.5:

Avoid to raise RuntimeError on RSGI headers methods when decoding fails
Bump dependencies

Open source →

2.2.516 Apr 2025

Fix a regression bug involving the event loop initialization and causing tasks to be attached to the wrong loop under some circumstances

Patch release

Changes since 2.2.4:

Fix a regression bug involving the event loop initialization and causing tasks to be attached to the wrong loop under some circumstances

Open source →

2.2.411 Apr 2025

Improve performance on iter-based responses on all protocols

Patch release

Changes since 2.2.3:

Improve performance on iter-based responses on all protocols
Bump files read buffer from 4k to 128k on RSGI response_file and ASGI pathsend
Fix a performance regression on Python > 3.10 (threads' state management related, special thanks to @davidhewitt)
Strip port address from WSGI REMOTE_ADDR environ var
Bump dependencies

Open source →

2.2.39 Apr 2025

Improve wording in WSGI warnings (#549 by @janbrasna)

Patch release

Changes since 2.2.2:

Improve wording in WSGI warnings (#549 by @janbrasna)
Fix a regression bug preventing reloader to work properly
Reduce logging noise for ASGI protocol on failed sends
Add (experimental) Linux i686 and armv7 wheels
Bump dependencies

Open source →

2.2.12 Apr 2025

Make PyFutureAwaitable compatible with anyio cancel scopes

Patch release

Changes since 2.2.0:

Make PyFutureAwaitable compatible with anyio cancel scopes
Avoid to alter ASGI scope's raw_path
Fix ASGI response headers when provided by generators
Default workers' kill timeout to 3.5 seconds when using reload on changes
Bump dependencies

Open source →

2.1.221 Mar 2025

Revert a change in WSGI implementation causing issues with threading module usage

Patch release

Changes since 2.1.1:

Revert a change in WSGI implementation causing issues with threading module usage

Open source →

2.1.119 Mar 2025

Fix a bug in RSGI implementation preventing HTTP protocol client_disconnect usage with access log enabled

Patch release

Changes since 2.1.0:

Fix a bug in RSGI implementation preventing HTTP protocol client_disconnect usage with access log enabled

Open source →

2.1.018 Mar 2025

Support Server header value to be customized in applications

What's Changed

New features

Support Server header value to be customized in applications
Bump RSGI spec to 1.5
- Add client_disconnect coroutine to HTTP protocol

Changes

Bump PyO3 to 0.24
Bump dependencies

Enhancements

Wait for inflight requests to complete on workers shutdown
Detect client disconnection in ASGI
Minor ASGI I/O state flow refactor

Fixes

Embed server shutdown

Open source →

2.0.14 Mar 2025

Fix a regression bug preventing anyio.to_thread.run_sync to run properly

Patch release

Changes since 2.0.0:

Fix a regression bug preventing anyio.to_thread.run_sync to run properly

Open source →

2.0.03 Mar 2025

Experimental support for *free-threaded* Python

What's Changed

New features

Experimental support for free-threaded Python
runtime-blocking-threads option
blocking-threads-idle-timeout option
http1-header-read-timeout option
PyPy 3.11 support
Embeddable server variant in granian.server.embed module

Changes

uvloop dependency is now optional and gated behind the relevant dependency extra
BREAKING renamed threads option to runtime-threads
BREAKING blocking-threads option now affects Python interop threads only
BREAKING removed threading-mode in favor of runtime-mode
- previous workers option is now st
- previous runtime option is now mt
BREAKING blocking-threads is now limited to 1 on ASGI and RSGI protocols
rust task implementation is now available on Python < 3.12 only
Removed PGO builds
Bump dependencies

Enhancements

Refactor the Rust task implementation
Refactor the Python blocking threadpool
Refactor application protocols failure handling
Re-export loops registry to facilitate customisations
Added warn messages for most common workers/threads misconfigurations
Review README's workers, threads and backpressure sections
Added range validations on all the relevant HTTP/2 options
Added back custom allocators, with jemalloc as default option and mimalloc as gated feature, used by default in the following cases:
- MUSL builds
- Windows builds
- Python 3.13t
Avoid to strip symbols from release builds

Open source →

1.7.630 Jan 2025

Fix a utf8 decoding bug on request paths leading to panics (#492 by @ritesh)

Patch release

Changes since 1.7.5:

Fix a utf8 decoding bug on request paths leading to panics (#492 by @ritesh)
Allow watchfiles dependency versions >= 1.0 (#496 by @RafaelWO)
Made asyncio the default task implementation due to instability of the rust one

Open source →

1.6.422 Nov 2024

Prevent async callbacks tasks to be GCollected before completion

Patch release

Changes since 1.6.3:

Prevent async callbacks tasks to be GCollected before completion
Avoid logger configuration errors when _granian logger is missing (#438 by @monosans)

Open source →

1.4.418 Jun 2024

Enhance memory allocations in WSGI input iterator (fix memory leaks in certain conditions)

Patch release

Changes since 1.4.3:

Enhance memory allocations in WSGI input iterator (fix memory leaks in certain conditions)
Fix WSGI response iterators not being closed under certain circumstances
Bump dependencies

Open source →