You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Quentin Pradet 1fe9418b15
Merge pull request #2368 from python-trio/dependabot/pip/typing-extensions-4.3.0
3 days ago
.builds 💚 Make Fedora build use Python 3.10 3 months ago
.github Fixed remaining Python 3.11 test failures (#2319) 2 months ago
docs Bump version to 0.21.0 4 weeks ago
logo Add references to forum everywhere, and spruce up README a bit 3 years ago
newsfragments Bump version to 0.21.0 4 weeks ago
notes-to-self avoid deprecated asyncio.Future() 1 year ago
trio docs: fix simple typo, subproces -> subprocess 4 days ago
.coveragerc Make Trio pass 'mypy -m trio -m trio.testing' 2 years ago
.gitattributes Add .gitattributes and mark generated files 1 year ago
.gitignore [#1500]: Remove unused __all__ variables from Trio modules 2 years ago
.readthedocs.yml Automatically run towncrier on RTD for in-development versions 2 years ago Add contributing doc, and switch to WeAllJS code of conduct 5 years ago Add contributing doc, and switch to WeAllJS code of conduct 5 years ago
LICENSE Consistently capitalize the word Trio 3 years ago
LICENSE.APACHE2 towards some kind of project layout 6 years ago
LICENSE.MIT add copyright notice to LICENCE.MIT 12 months ago Include in sdists 5 years ago
README.rst Drop Python 3.6 support (#2210) 5 months ago Make Trio pass 'mypy -m trio -m trio.testing' 2 years ago Drop Python 3.6 support (#2210) 5 months ago Require attrs >= 19.2.0 in more places 3 years ago
docs-requirements.txt Bump requests from 2.28.0 to 2.28.1 3 days ago
mypy.ini Make Trio pass 'mypy -m trio -m trio.testing' 2 years ago
pyproject.toml Drop Python 3.6 support (#2210) 5 months ago Make setuptools license field SPDX-compliant 4 weeks ago Bump ipython to 7.31.1 5 months ago
test-requirements.txt Bump typing-extensions from 4.2.0 to 4.3.0 3 days ago


Join chatroom

Join forum


Latest PyPi version

Latest conda-forge version

Test coverage

Trio – a friendly Python library for async concurrency and I/O


The Trio project aims to produce a production-quality, permissively licensed, async/await-native I/O library for Python. Like all async libraries, its main purpose is to help you write programs that do multiple things at the same time with parallelized I/O. A web spider that wants to fetch lots of pages in parallel, a web server that needs to juggle lots of downloads and websocket connections simultaneously, a process supervisor monitoring multiple subprocesses... that sort of thing. Compared to other libraries, Trio attempts to distinguish itself with an obsessive focus on usability and correctness. Concurrency is complicated; we try to make it easy to get things right.

Trio was built from the ground up to take advantage of the latest Python features, and draws inspiration from many sources, in particular Dave Beazley's Curio. The resulting design is radically simpler than older competitors like asyncio and Twisted, yet just as capable. Trio is the Python I/O library I always wanted; I find it makes building I/O-oriented programs easier, less error-prone, and just plain more fun. Perhaps you'll find the same.

This project is young and still somewhat experimental: the overall design is solid, and the existing features are fully tested and documented, but you may encounter missing functionality or rough edges. We do encourage you to use it, but you should read and subscribe to issue #1 to get a warning and a chance to give feedback about any compatibility-breaking changes.

Where to next?

I want to try it out! Awesome! We have a friendly tutorial to get you started; no prior experience with async coding is required.

Ugh, I don't want to read all that – show me some code! If you're impatient, then here's a simple concurrency example, an echo client, and an echo server.

How does Trio make programs easier to read and reason about than competing approaches? Trio is based on a new way of thinking that we call "structured concurrency". The best theoretical introduction is the article Notes on structured concurrency, or: Go statement considered harmful. Or, check out this talk at PyCon 2018 to see a demonstration of implementing the "Happy Eyeballs" algorithm in an older library versus Trio.

Cool, but will it work on my system? Probably! As long as you have some kind of Python 3.7-or-better (CPython or the latest PyPy3 are both fine), and are using Linux, macOS, Windows, or FreeBSD, then Trio will work. Other environments might work too, but those are the ones we test on. And all of our dependencies are pure Python, except for CFFI on Windows, which has wheels available, so installation should be easy (no C compiler needed).

I tried it, but it's not working. Sorry to hear that! You can try asking for help in our chat room or forum, filing a bug, or posting a question on StackOverflow, and we'll do our best to help you out.

Trio is awesome, and I want to help make it more awesome! You're the best! There's tons of work to do – filling in missing functionality, building up an ecosystem of Trio-using libraries, usability testing (e.g., maybe try teaching yourself or a friend to use Trio and make a list of every error message you hit and place where you got confused?), improving the docs, ... check out our guide for contributors!

I don't have any immediate plans to use it, but I love geeking out about I/O library design! That's a little weird? But let's be honest, you'll fit in great around here. We have a whole sub-forum for discussing structured concurrency (developers of other systems welcome!). Or check out our discussion of design choices, reading list, and issues tagged design-discussion.

I want to make sure my company's lawyers won't get angry at me! No worries, Trio is permissively licensed under your choice of MIT or Apache 2. See LICENSE for details.

Code of conduct

Contributors are requested to follow our code of conduct in all project spaces.