# About

pyfuse3 is a set of Python 3 bindings for libfuse 3. It provides an asynchronous API compatible with Trio and asyncio, and enables you to easily write a full-featured Linux filesystem in Python.

pyfuse3 releases can be downloaded from PyPi. The documentation can be read online and is also included in the `doc/html` directory of the pyfuse3 tarball.

## Getting Help

Please report any bugs on the issue tracker. For discussion and questions, please use the general FUSE mailing list or GitHub Discussions.

## Development Status

pyfuse3 is stable when used with Trio. The current maintainers ensure that bugs are addressed and pyfuse3 continues to work with new Python and libfuse versions. There is no plan to add new features or other non-bugfix work. However, pull requests for new features or other improvements may be accepted.

Using pyfuse3 with asyncio (rather than Trio) support is less well tested, there may be bugs, and some of them may not be easily fixable.

If you need a synchronous (non async) implementation, mfusepy is a maintained alternative.

## Contributing

The pyfuse3 source code is available on GitHub.