https://github.com/agronholm/anyio

High level asynchronous concurrency and networking framework that works on top of either trio or asyncio
https://github.com/agronholm/anyio

async-await asyncio curio trio

Last synced: 3 months ago
JSON representation

High level asynchronous concurrency and networking framework that works on top of either trio or asyncio

• Host: GitHub
• URL: https://github.com/agronholm/anyio
• Owner: agronholm
• License: mit
• Created: 2018-08-19T21:07:18.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2025-05-06T19:37:23.000Z (12 months ago)
• Last Synced: 2025-05-06T21:09:13.421Z (12 months ago)
• Topics: async-await, asyncio, curio, trio
• Language: Python
• Homepage:
• Size: 2.25 MB
• Stars: 2,023
• Watchers: 25
• Forks: 150
• Open Issues: 67
• Metadata Files:
  • Readme: README.rst
  • Contributing: docs/contributing.rst
  • License: LICENSE
  • Support: docs/support.rst

Awesome Lists containing this project

• awesome-list - AnyIO - High level asynchronous concurrency and networking framework that works on top of either trio or asyncio. (Process, Thread & Coroutine / C++/C Toolkit)
• awesomeLibrary - anyio - High level asynchronous concurrency and networking framework that works on top of either trio or asyncio (语言资源库 / python)
• awesome-asyncio - AnyIO - High level asynchronous concurrency and networking framework that works on top of either trio or asyncio. (Alternatives to asyncio)
• best-of-python - GitHub - 16% open · ⏱️ 04.11.2025): (Asynchronous Programming)
• fucking-awesome-python - anyio - A high-level async concurrency and networking framework that works on top of asyncio or trio. (Asynchronous Programming)
• awesome-python - anyio - A high-level async concurrency and networking framework that works on top of asyncio or trio. (Asynchronous Programming)

README

          
.. image:: https://github.com/agronholm/anyio/actions/workflows/test.yml/badge.svg

  :target: https://github.com/agronholm/anyio/actions/workflows/test.yml

  :alt: Build Status

.. image:: https://coveralls.io/repos/github/agronholm/anyio/badge.svg?branch=master

  :target: https://coveralls.io/github/agronholm/anyio?branch=master

  :alt: Code Coverage

.. image:: https://readthedocs.org/projects/anyio/badge/?version=latest

  :target: https://anyio.readthedocs.io/en/latest/?badge=latest

  :alt: Documentation

.. image:: https://badges.gitter.im/gitterHQ/gitter.svg

  :target: https://gitter.im/python-trio/AnyIO

  :alt: Gitter chat

AnyIO is an asynchronous networking and concurrency library that works on top of either asyncio_ or

Trio_. It implements Trio-like `structured concurrency`_ (SC) on top of asyncio and works in harmony

with the native SC of Trio itself.

Applications and libraries written against AnyIO's API will run unmodified on either asyncio_ or

Trio_. AnyIO can also be adopted into a library or application incrementally – bit by bit, no full

refactoring necessary. It will blend in with the native libraries of your chosen backend.

To find out why you might want to use AnyIO's APIs instead of asyncio's, you can read about it

`here `_.

Documentation

-------------

View full documentation at: https://anyio.readthedocs.io/

Features

--------

AnyIO offers the following functionality:

* Task groups (nurseries_ in trio terminology)

* High-level networking (TCP, UDP and UNIX sockets)

  * `Happy eyeballs`_ algorithm for TCP connections (more robust than that of asyncio on Python

    3.8)

  * async/await style UDP sockets (unlike asyncio where you still have to use Transports and

    Protocols)

* A versatile API for byte streams and object streams

* Inter-task synchronization and communication (locks, conditions, events, semaphores, object

  streams)

* Worker threads

* Subprocesses

* Subinterpreter support for code parallelization (on Python 3.13 and later)

* Asynchronous file I/O (using worker threads)

* Signal handling

* Asynchronous version of the functools_ module

AnyIO also comes with its own pytest_ plugin which also supports asynchronous fixtures.

It even works with the popular Hypothesis_ library.

.. _asyncio: https://docs.python.org/3/library/asyncio.html

.. _Trio: https://github.com/python-trio/trio

.. _structured concurrency: https://en.wikipedia.org/wiki/Structured_concurrency

.. _nurseries: https://trio.readthedocs.io/en/stable/reference-core.html#nurseries-and-spawning

.. _Happy eyeballs: https://en.wikipedia.org/wiki/Happy_Eyeballs

.. _pytest: https://docs.pytest.org/en/latest/

.. _functools: https://docs.python.org/3/library/functools.html

.. _Hypothesis: https://hypothesis.works/