---
id: sphinx-autoapi
version: "3.8.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# sphinx-autoapi — Sphinx API documentation generator

License: permissive · Maintenance: active · Downloads: 3.7M/mo

## What it is and what it does

Sphinx AutoAPI is a Sphinx extension that generates API documentation by parsing source code directly, rather than importing and introspecting live modules. Unlike the traditional Sphinx autodoc extension, AutoAPI finds and documents your code without needing to run or load it, making it safer for documenting untrusted or complex projects. It integrates into your Sphinx build process, automatically creating an `autoapi/` directory with generated documentation and adding it to your table of contents.

The package depends on astroid for code parsing, Jinja2 for templating, PyYAML for configuration, and sphinx itself. It supports current Python versions (3.10 through 3.14) and has been actively maintained since 2015, with no known security vulnerabilities. Installation is straightforward—a single pip command and two lines in your Sphinx conf.py—and the extension then handles the rest during documentation builds.

Use it for:

- Generate API docs for a Python project without importing code that may have external dependencies or side effects.
- Automatically document a large codebase where manual autodoc directives would be tedious or error-prone.
- Create API reference documentation that stays in sync with source code during the build process.
- Document multiple source directories or packages in a single Sphinx project without hand-writing module indices.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Sphinx AutoAPI generates complete API documentation by parsing source code, without requiring imports or manual authoring—it integrates as a Sphinx extension to automatically create and organize API docs.

Yes. This is a mature, actively maintained Sphinx extension with low install friction, no vulnerabilities, and a permissive license. It solves a real problem—generating complete API docs from source code without imports—that makes it valuable for projects where autodoc is impractical. Install it if you use Sphinx and want automatic API documentation.

## Install

pip install sphinx-autoapi
uv add sphinx-autoapi
poetry add sphinx-autoapi

## Installing sphinx-autoapi

Before you install: Low friction: a pure-Python wheel with four straightforward runtime dependencies (astroid, Jinja2, PyYAML, sphinx). Active maintenance with a recent release and no known vulnerabilities.

License in practice: MIT license (permissive); you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install sphinx-autoapi

# In conf.py:
extensions.append('autoapi.extension')
autoapi_dirs = ['path/to/source/files', 'src']

Requires Python 3.10 or later and an existing Sphinx project to extend.

Verify before relying:

- Whether AutoAPI handles all language types equally well (the fact sheet confirms it parses source code but does not specify which languages).
- Performance characteristics when documenting very large codebases or deeply nested module hierarchies.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 3.7M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

sphinx api documentation generator, automatic api docs from source code, sphinx extension autodoc alternative, parse source code generate docs, sphinx autoapi, api documentation without imports, static code parsing documentation, sphinx-extension, api-documentation, code-parsing

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