---
id: aiofile
version: "3.12.3"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aiofile — Asynchronous file operations.

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install aiofile
uv add aiofile
poetry add aiofile

## Description

# AIOFile

[![Github Actions](https://github.com/mosquito/aiofile/workflows/ci/badge.svg)](https://github.com/mosquito/aiofile/actions?query=workflow%3Aci) [![Latest Version](https://img.shields.io/pypi/v/aiofile.svg)](https://pypi.python.org/pypi/aiofile/) [![Python Versions](https://img.shields.io/pypi/pyversions/aiofile.svg)](https://pypi.python.org/pypi/aiofile/) [![License](https://img.shields.io/pypi/l/aiofile.svg)](https://pypi.python.org/pypi/aiofile/) [![Coverage Status](https://coveralls.io/repos/github/mosquito/aiofile/badge.svg?branch=master)](https://coveralls.io/github/mosquito/aiofile?branch=master)

Real asynchronous file operations with asyncio support.

## Features

* Since version 2.0.0, uses [caio](https://pypi.org/project/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](https://pagure.io/libaio).
  * **Thread-based (C)** — a [threadpool](https://github.com/mbrossard/threadpool/)-backed
    implementation for POSIX systems (macOS, Linux).
  * **Pure Python** — a thread-based fallback for any platform.
*...

## AI interpretation — verify before relying

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.

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.

[View on SkillFed](https://skillfed.io/packages/aiofile) · [View on PyPI](https://pypi.org/project/aiofile/)