aiorun

What it is and what it does

aiorun is a lightweight wrapper around asyncio that eliminates boilerplate for long-lived async applications. Instead of manually creating event loops, scheduling tasks, setting up signal handlers, and orchestrating graceful shutdown, you pass a coroutine to aiorun.run() and it handles the rest—creating the loop, running forever, catching SIGINT and SIGTERM, cancelling pending tasks, and closing cleanly.

The package is designed for servers and daemon-like applications that should keep running until explicitly stopped. Unlike the standard library's asyncio.run(), which exits when the coroutine completes, aiorun.run() runs indefinitely unless you call loop.stop() or an unhandled exception occurs (if stop_on_unhandled_errors=True is set). It automatically gathers and cancels all pending tasks during shutdown, waits for executor jobs to finish, and closes the event loop.

Use it for

• Building a TCP or HTTP server that needs clean signal handling and task cancellation on shutdown.
• Running a long-lived async daemon or background worker that should survive transient errors.
• Simplifying asyncio application startup when you want to avoid writing shutdown boilerplate.
• Creating a resilient API service where one endpoint's exception shouldn't crash the entire process.
• Prototyping async applications quickly without manually managing event loop lifecycle.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

aiorun on PyPI

Before you install

Low friction—pure Python, no runtime dependencies, and actively maintained with recent releases. Last commit was 2026-08-10 and the package supports current Python versions (3.8 through 3.12).

Requires Python 3.7 or later. Note that aiorun.run() runs forever by default—call loop.stop() inside your coroutine to exit, or pass stop_on_unhandled_errors=True to crash on exceptions.

License in practice

Permissive license treatment means you can use this in commercial and proprietary projects without restrictive obligations.

Quickstart

import asyncio
from aiorun import run

async def main():
    await asyncio.sleep(1.0)

if __name__ == '__main__':
    run(main())

Package facts

Evidence: aiorun-2025.1.1-py3-none-any.whl

Tags

More Application Frameworks packages

See also aiojobs · aiotools · asyncio-atexit · asyncio-dgram · wait-for2 · aiomonitor · aioprocessing · aioserial · clarifai-protocol · aiodebug