aiohttp-swagger
Swagger API Documentation builder for aiohttp server
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
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 · maintenance · safety
BSD (permissive) — BSD license is permissive, allowing commercial and private use with minimal restrictions—suitable for most projects that can include a license notice.
last release 2021-10-22 (1757 days) · last repo commit 2026-04-13 · 187 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 222,853 downloads/mo, #9,258 on PyPI
Alternatives
Verify before relying
pip install aiohttp-swagger
from aiohttp import web
from aiohttp_swagger import setup_swagger
app = web.Application()
setup_swagger(app)- 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
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 on it.
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
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 packagespyYAMLjinja2aiohttp |
| Maintenance | Actively maintained 1,757 days since the last release |
| Last repo commit | |
| First released | |
| 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 |
| Classifiers | 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 |
Evidence: aiohttp_swagger-1.0.16-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “swagger documentation for aiohttp”
- aiohttp-swaggerGenerates Swagger API documentation and interactive UI for aiohttp…
- aiohttp-swagger3Integrates OpenAPI 3 documentation and request validation into…
- swagger-ui-pyIntegrates Swagger UI documentation into Python web frameworks…
Give your agent the search over MCP, or paste the wish link into any chat.
More Security packages
Provides Python bindings to the FreeDesktop.org Secret Service API for securely storing and retrieving passwords and secrets through GNOME Keyring, KWallet, or KeePassXC.
MSAL for Python handles OAuth2 and OpenID Connect authentication with Microsoft identity services, managing token acquisition, caching, and refresh for applications integrating with Microsoft Entra ID, Microsoft Accounts, and Azure AD B2C.
joserfc implements JOSE standards (JWS, JWE, JWK, JWT, and related RFCs) for signing, encrypting, and managing JSON-based cryptographic tokens in Python.
Authlib provides a complete implementation of OAuth 1.0, OAuth 2.0, and OpenID Connect 1.0 for building both authentication clients and servers, with built-in support for JWS, JWK, JWA, and JWT standards.
Provides low-level CFFI bindings to the official Argon2 password hashing algorithm for use by libraries and applications that need direct access to Argon2 without higher-level abstractions.
ADAL for Python authenticates applications with Azure Active Directory to obtain tokens for accessing Azure AD-protected resources.
Install only if maintaining existing code that already depends on it, and plan a migration.
See also swagger-ui-py · assemblyline-ui · flask-swagger-ui · aiohttp-swagger3 · mkdocs-swagger-ui-tag · flask-openapi3-swagger · mkdocs-render-swagger-plugin · scalar-fastapi · taskcluster-urls · assisted-service-client