aiohttp-swagger

Swagger API Documentation builder for aiohttp server

aiohttp-swagger v1.0.16 222.9K downloads/30d#9,258 on PyPI★ 187

Permissive license BSD Active released 2021-10-22

What it is and what it does

aiohttp-swagger is a plugin that integrates Swagger API documentation generation into aiohttp web servers. It lets you annotate your route handlers and automatically generates both machine-readable API specs and an interactive Swagger UI console for exploring and testing your endpoints. The package depends on aiohttp for the web framework, pyYAML for spec serialization, and jinja2 for rendering the documentation interface.

The project is actively maintained but explicitly seeking new maintainers. It has been in use since its 2016 release and maintains a modest but steady download rate. The codebase is permissively licensed under BSD, making it suitable for most use cases.

Use it for:

Auto-generate interactive API documentation for aiohttp REST services without manual spec maintenance
Provide a built-in Swagger UI console for developers to test endpoints directly from the browser
Integrate API documentation into existing aiohttp applications with minimal boilerplate
Export machine-readable Swagger specs for API clients and third-party tools

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Generates Swagger API documentation and interactive UI for aiohttp web servers, allowing you to document REST endpoints and browse them through a Swagger console.

Yes, if you are actively using aiohttp and need Swagger documentation. The low install friction, permissive license, and active maintenance status make it a reasonable choice. However, verify compatibility with your Python version and aiohttp release before committing, and be aware that the maintainer is seeking new contributors—consider whether long-term support aligns with your project's needs.

Install

aiohttp-swagger on PyPI

pip

pip install aiohttp-swagger

uv

uv add aiohttp-swagger

poetry

poetry add aiohttp-swagger

Installing aiohttp-swagger

Before you install

Low install friction with three lightweight runtime dependencies (pyYAML, jinja2, aiohttp). Maintenance status is active, though the last release was in 2021 and the project explicitly seeks maintainers.

License in practice

BSD license is permissive, allowing commercial and private use with minimal restrictions—suitable for most projects that can include a license notice.

Quickstart

pip install aiohttp-swagger

from aiohttp import web
from aiohttp_swagger import setup_swagger

app = web.Application()
setup_swagger(app)

Verify before relying

Whether the package works with Python versions beyond 3.8 (classifiers list 3.5–3.8, but requires_python is unspecified)
Current compatibility with recent aiohttp releases and whether breaking changes have occurred since 2021
Whether Swagger 2.0 or OpenAPI 3.0 spec is supported

Package facts

License	BSD (permissive)
Python support	not specified
Install friction	low — pure-Python wheel
Runtime dependencies	3 — pyYAML, jinja2, aiohttp
Maintenance	actively maintained — 1,757 days since the last release
Last repo commit	2026-04-13
First released	2016-10-25
Downloads	222,853/month — #9,258 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-14)

Evidence: aiohttp_swagger-1.0.16-py3-none-any.whl

Environment :: ConsoleIntended Audience :: Other AudienceIntended Audience :: System AdministratorsLicense :: OSI Approved :: BSD LicenseOperating System :: MacOSOperating System :: Microsoft :: WindowsOperating System :: POSIXProgramming Language :: Python :: 3.5Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Topic :: Security