Thomas Winkelmann
Repositories
8
 Projects Packages
2
 Public activity Starred repositories

quicstar (1.0.1)

Published 2025-11-27 23:11:30 +01:00 by DiamantTh

Installation

pip install --index-url  quicstar

About this package

Lightweight, modern Python web server with HTTP/3 and flexible deployment

Quicstar

Quicstar is a lightweight Python package with a built-in web server that ships as a simple pip install. The server speaks modern protocols (HTTP/1.1, HTTP/2, HTTP/3/QUIC), runs comfortably behind Traefik or inside Docker, and can host standalone apps or framework ASGI apps such as Django.

Features

  • HTTP/3 & QUIC with ALPN; configurable HTTP/1.1-only mode.
  • Framework-friendly: serves any ASGI app (for example myproject.asgi:application).
  • Multi-core ready: worker count configurable; defaults to CPU core count.
  • Container-ready: reads environment variables and TOML configs; sane defaults for Traefik/Docker.
  • TLS ready: certificate/key support (required for HTTP/3/QUIC).
  • Low overhead: built on Hypercorn, also handling HTTP/2 and WebSockets.

Installation

pip install .

Run standalone

quicstar --config examples/quicstar.example.toml

Without a config file, Quicstar uses environment variables and launches the internal minimal app:

QUICSTAR_HOST=0.0.0.0 QUICSTAR_PORT=8000 quicstar --protocol http1

Key options (also available via env vars):

  • --app / QUICSTAR_APP: ASGI path, e.g., Django myproject.asgi:application.
  • --protocol / QUICSTAR_PROTOCOL: auto, http3, or http1.
  • --certfile, --keyfile: TLS files for HTTP/3/QUIC.
  • --quic-bind: separate QUIC bind address if Traefik terminates TLS.
  • --workers: number of processes for multi-core deployments.

Using with Django or other frameworks

Point Quicstar to your ASGI app:

quicstar --app myproject.asgi:application --protocol auto --certfile /certs/fullchain.pem --keyfile /certs/privkey.pem

Framework-specific configuration (settings, logging, etc.) stays untouched; Quicstar only handles serving.

TOML configuration

See examples/quicstar.example.toml for a human-readable standalone configuration.

Docker & Traefik notes

  • Default bind is 0.0.0.0, making it container-friendly.
  • Use --quic-bind when you need a dedicated QUIC port alongside Traefik TLS termination.
  • Mount certificate volumes as needed for TLS.

HTTP/1.1-only mode

Set --protocol http1 or QUICSTAR_PROTOCOL=http1 to limit serving to HTTP/1.1 (e.g., for minimal memory usage or legacy clients).

Additional protocols

Hypercorn automatically supports HTTP/2 and WebSockets; QUIC is enabled when certificates are configured.

Requirements

Requires Python: >=3.10
Details
PyPI
2025-11-27 23:11:30 +01:00
0
Thomas Winkelmann
LicenseRef-Quicstar-NSSL
22 KiB
Assets (1)
quicstar-1.0.1-py3-none-any.whl 22 KiB
Versions (4) View all
1.0.3 2025-11-28
1.0.2 2025-11-28
1.0.1 2025-11-27
1.0.0 2025-11-27