Skip to main content

m0serve

Realtime from a synchronous Python app, with no added infrastructure.

A WSGI/ASGI server written in Mojo. Point it at a Django, Flask, FastHTML or Starlette app and it serves it — no Mojo toolchain required, no compilation step, nothing to configure:

pip install m0serve
m0serve myproject.wsgi:application

What it adds over gunicorn or uvicorn is that a plain synchronous view can hold a Server-Sent Events stream or a WebSocket, by answering with two response headers — and reach every subscriber on every worker with one function call. No Channels, no Redis, no daphne, no Pushpin, no second process:

from m0serve import m0pub

def events(request):                    # an ordinary synchronous view
    r = HttpResponse(": connected\n\n", content_type="text/event-stream")
    r["M0-Hold"] = "stream"             # m0serve holds the connection open
    r["M0-Channel"] = "news"            # ...subscribed to this channel
    return r                            # Django's part in it ends here


def announce(request):                  # any view, command, or cron job
    m0pub.publish("news", "deploy finished")
    return HttpResponse("ok")

Run it with m0serve myproject.wsgi --realtime. The view runs first, with sessions and permissions in hand — which is where your auth belongs. Under gunicorn the two headers are ignored and the same view degrades to a short plain response, so adopting this is not a fork of your codebase.

The ten-minute quickstart goes from pip install to live multi-tab sync from one synchronous Django file: https://github.com/codetalcott/mojo-http/blob/main/QUICKSTART.md — every command in it is executed by CI on every pull request.

It also hosts several applications in one process, each in its native execution mode: m0serve --mount /=shop.wsgi --mount /app=live.asgi runs sync Django on handler threads and async FastHTML on an asyncio executor, behind one listener with one shutdown.

The protocol is detected from the object, so the same command serves WSGI and ASGI. m0serve --help lists the flags; --workers N, --threads N (on free-threaded CPython) and --blocking-threads N are the topology ones.

When it is up it prints one line per worker — 🔥 m0serve: myproject.wsgi: application on http://0.0.0.0:8000 (protocol=wsgi workers=4) — after the application has been imported, so "it printed" means "it is serving". For an orchestrator use --health-path /health or a TCP check rather than the log line.

If something will not start, m0serve --doctor myproject.wsgi prints a JSON report — the interpreter it resolved and the virtualenv it came from, the spec it discovered, the topology it settled on, and every startup check with the fix for the ones that failed — and exits with the code the server itself would have used. It binds nothing and imports nothing twice.

What is in the wheel

One compiled binary and the Mojo runtime it loads. No CPython — m0serve resolves libpython at run time from the interpreter it is installed beside, which is why there is no ABI tag and one wheel per platform covers CPython 3.10 through 3.14, free-threaded builds included. It has no Python dependencies and fetches nothing at install time.

Install it into the same virtual environment as your application, the way you would gunicorn or uvicorn; the console script points the embedded interpreter at that environment.

Platforms

platform status
macOS arm64 (Apple Silicon) supported
Linux x86_64 (glibc) supported
Linux aarch64 (Graviton, Ampere, arm64 Docker) supported
macOS x86_64 (Intel) not possible — Modular ships no Intel Mac toolchain
musl / Alpine, Windows not supported

The wheel's filename carries the exact macOS and glibc floors it was built against. On an older system pip declines to install it rather than installing something that crashes.

Status

Pre-1.0 and deliberately small: HTTP/1.1 only, no TLS, no HTTP/2 — terminate at a proxy, which is gunicorn's answer too. The API will change before 1.0.

The full capability matrix, with the CI gate behind each row, is docs/SPEC.md.

Source, documentation and issues: https://github.com/codetalcott/mojo-http

Licence

MIT, and the wheel redistributes third-party components under their own terms — the Mojo runtime (Apache-2.0 with LLVM Exceptions) and a fork of lightbug_http (MIT). Full text and attribution ship inside the wheel; see NOTICE.txt beside the installed package.

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.

m0serve-0.15.1-py3-none-manylinux_2_35_x86_64.whl (1.5 MB view details)

Uploaded Python 3manylinux: glibc 2.35+ x86-64

m0serve-0.15.1-py3-none-manylinux_2_35_aarch64.whl (1.4 MB view details)

Uploaded Python 3manylinux: glibc 2.35+ ARM64

m0serve-0.15.1-py3-none-macosx_13_0_arm64.whl (1.2 MB view details)

Uploaded Python 3macOS 13.0+ ARM64

File details

Details for the file m0serve-0.15.1-py3-none-manylinux_2_35_x86_64.whl.

File metadata

File hashes

Hashes for m0serve-0.15.1-py3-none-manylinux_2_35_x86_64.whl
Algorithm Hash digest
SHA256 8344e6ca53a1ef069ca271809894c5f638afebd2d10f1fb09b9d3e6e193d5412
MD5 2ec648c0f1ee2e6f3be1d57b0e58fcc9
BLAKE2b-256 08ab63ba7b70cdad41cbc0402ca77c46b907f18eceea8ad4813f9341ae0ba592

See more details on using hashes here.

Provenance

The following attestation bundles were made for m0serve-0.15.1-py3-none-manylinux_2_35_x86_64.whl:

Publisher: release.yml on codetalcott/mojo-http

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file m0serve-0.15.1-py3-none-manylinux_2_35_aarch64.whl.

File metadata

File hashes

Hashes for m0serve-0.15.1-py3-none-manylinux_2_35_aarch64.whl
Algorithm Hash digest
SHA256 db598c57082e94c89dd2e9988915e8623cb22f4b5c9abce82018eedcb9fa87bf
MD5 a9ee30e787ee92061f30e3f119e0a02b
BLAKE2b-256 56b30dc5c3901a9f1467e2e0ccd7a8a8f2d2d19b5691b3ef73d062e77f82f609

See more details on using hashes here.

Provenance

The following attestation bundles were made for m0serve-0.15.1-py3-none-manylinux_2_35_aarch64.whl:

Publisher: release.yml on codetalcott/mojo-http

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file m0serve-0.15.1-py3-none-macosx_13_0_arm64.whl.

File metadata

File hashes

Hashes for m0serve-0.15.1-py3-none-macosx_13_0_arm64.whl
Algorithm Hash digest
SHA256 f7130dac8b9c1662411b97e32f67089b3bf1cde743e210a9e65f1e91248e8d63
MD5 7cc2c77b1ed5708d01e8d4e538eeba0e
BLAKE2b-256 352dba42590cbf107b73c4daac935cae929423f0020ab52054ded4c1c5bf4b76

See more details on using hashes here.

Provenance

The following attestation bundles were made for m0serve-0.15.1-py3-none-macosx_13_0_arm64.whl:

Publisher: release.yml on codetalcott/mojo-http

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.17.0

3 files

0.16.0

3 files

This release

0.15.1 This release

3 files

0.15.0

3 files

0.14.1

3 files

0.14.0

3 files

0.13.0

3 files

0.12.0

3 files

0.11.0

3 files

0.10.0

2 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