aiofile

Asynchronous file operations.

aiofile Permissive license Apache-2.0 Active ★ 584 v3.12.3 released 2026-08-04

Install

aiofile on PyPI

pip

pip install aiofile

uv

uv add aiofile

poetry

poetry add aiofile

Package facts

License	Apache-2.0 (permissive)
Python support	supports the current Python release (>=3.11)
Install friction	low — pure-Python wheel
Runtime dependencies	1 — caio
Maintenance	actively maintained — 9 days since the last release
Last repo commit	2026-08-04
First released	2018-02-06
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: aiofile-3.12.3-py3-none-any.whl

Keywords: aio, asyncio, fileio, io, python

Development Status :: 5 - Production/StableEnvironment :: ConsoleIntended Audience :: DevelopersIntended Audience :: EducationIntended Audience :: End Users/DesktopLicense :: OSI Approved :: Apache Software LicenseNatural Language :: EnglishNatural Language :: RussianOperating System :: MacOS :: MacOS XOperating System :: POSIX :: LinuxProgramming Language :: PythonProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: Implementation :: CPythonTopic :: Software Development :: LibrariesTopic :: SystemTopic :: System :: Operating System

About aiofile

from the package's own PyPI description — quoted content, verbatim

AIOFile

Github Actions (image) Latest Version (image) Python Versions (image) License (image) Coverage Status (image)

Real asynchronous file operations with asyncio support.

Features

Since version 2.0.0, uses caio, which provides multiple async I/O backends:
Linux io_uring — the modern, high-performance Linux kernel AIO interface.
Linux libaio — the classic kernel AIO mechanism via libaio.
Thread-based (C) — a threadpool-backed implementation for POSIX systems (macOS, Linux).
Pure Python — a thread-based fallback for any platform. *...

Read as markdown · JSON record · Source repository · Homepage

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Provides real asynchronous file I/O operations for asyncio programs, automatically selecting the best backend (io_uring, libaio, thread-pool, or pure Python) based on system capabilities.

Low friction: pure Python wheel with a single compiled dependency (caio). Actively maintained with recent releases; last commit 2026-08-04 and 9 days since latest version. Supports Python 3.11–3.14.

Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.

Usage

import asyncio
from aiofile import async_open

async def main():
    async with async_open('test.txt', 'w+') as afp:
        await afp.write('Hello')
        afp.seek(0)
        print(await afp.read())

asyncio.run(main())

Requires Python 3.11+. Linux native AIO and io_uring backends cannot open special files (/proc, /sys); use thread-based context for those.

Verdict: Production-ready async file I/O for asyncio applications with zero security vulnerabilities and active maintenance. Low install friction and permissive licensing make it a safe choice. Best suited for Linux/macOS; Windows users should verify thread-pool performance meets their needs.

Needs verification

Performance characteristics of each backend (io_uring vs. libaio vs. thread-pool) under typical workloads
Whether caio's compiled dependency introduces any platform-specific build issues beyond the documented limitations

asyncio file operationsasync file I/Onon-blocking file read writeaio file handlingasyncio file readingasync file operations pythoncaio backed file access