---
id: aiofiles
version: "25.1.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aiofiles — File support for asyncio.

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

## Install

pip install aiofiles
uv add aiofiles
poetry add aiofiles

## Description

# aiofiles: file support for asyncio

[![PyPI](https://img.shields.io/pypi/v/aiofiles.svg)](https://pypi.python.org/pypi/aiofiles)
[![Build](https://github.com/Tinche/aiofiles/workflows/CI/badge.svg)](https://github.com/Tinche/aiofiles/actions)
[![Coverage](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/Tinche/882f02e3df32136c847ba90d2688f06e/raw/covbadge.json)](https://github.com/Tinche/aiofiles/actions/workflows/main.yml)
[![Supported Python versions](https://img.shields.io/pypi/pyversions/aiofiles.svg)](https://github.com/Tinche/aiofiles)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

**aiofiles** is an Apache2 licensed library, written in Python, for handling local
disk files in asyncio applications.

Ordinary local file IO is blocking, and cannot easily and portably be made
asynchronous. This means doing file IO may interfere with asyncio applications,
which shouldn't block the executing thread. aiofiles helps with this by
introducing asynchronous versions of files that support delegating operations to
a separate thread...

## AI interpretation — verify before relying

aiofiles provides asynchronous file I/O operations for asyncio applications, delegating blocking disk operations to a thread pool so they don't freeze the event loop.

Verdict: aiofiles is a production-stable, zero-dependency library for async file operations in asyncio applications. Active maintenance, permissive licensing, and no known vulnerabilities make it a reliable choice for projects needing non-blocking disk I/O.

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