apispec-webframeworks
Web framework plugins for apispec.
Decision gist · record as of 2026-08-14
Yes, if you use Flask, aiohttp, Bottle, or Tornado and want to generate OpenAPI specs from your code. It has low install friction, active maintenance, no known vulnerabilities, permissive licensing, and solves a real problem—keeping API documentation synchronized with implementation.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.8 or later; requires apispec to be installed separately.
- Low friction: single lightweight dependency on apispec, pure Python wheel, actively maintained with recent commits.
License · maintenance · safety
permissive license (permissive) — MIT licensed under permissive terms, allowing commercial and private use with minimal restrictions.
last release 2024-09-16 (697 days) · last repo commit 2026-08-03 · 33 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 627,434 downloads/mo, #5,682 on PyPI
Alternatives
Verify before relying
pip install apispec-webframeworks
from apispec_webframeworks.flask import FlaskPlugin
from apispec import APISpec
spec = APISpec(
title="API",
version="1.0.0",
plugins=[FlaskPlugin()],
)- Whether all four framework plugins (aiohttp, bottle, flask, tornado) are production-ready or have known limitations
- Performance impact when generating specs for large applications with many routes
What it is and what it does
apispec-webframeworks provides plugins that bridge web frameworks and apispec, a library for building OpenAPI specifications programmatically. Instead of writing OpenAPI YAML by hand, you annotate your route handlers with docstrings and let the plugins extract parameter schemas, request/response types, and route metadata automatically. The package was split out from apispec's core and now maintains separate plugins for Flask, aiohttp, Bottle, and Tornado.
You install it alongside apispec and your chosen framework, then register the appropriate plugin when creating your APISpec instance. The plugins inspect your application's routes and docstrings to populate the specification, reducing duplication between your code and documentation. It requires Python 3.8 or later and has no heavy system dependencies.
Use it for
- Generate OpenAPI specs for Flask REST APIs without manually writing YAML or JSON definitions
- Automatically document Tornado or aiohttp async endpoints with request/response schemas
- Migrate from older apispec versions by updating imports to use this separate package
- Keep API documentation in sync with code by deriving specs from route handlers
- Integrate OpenAPI specs into Swagger UI or ReDoc for interactive API browsing
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use Flask, aiohttp, Bottle, or Tornado and want to generate OpenAPI specs from your code.
It has low install friction, active maintenance, no known vulnerabilities, permissive licensing, and solves a real problem—keeping API documentation synchronized with implementation.
Install
apispec-webframeworks on PyPI
Before you install
Low friction: single lightweight dependency on apispec, pure Python wheel, actively maintained with recent commits.
Requires Python 3.8 or later; requires apispec to be installed separately.
License in practice
MIT licensed under permissive terms, allowing commercial and private use with minimal restrictions.
Quickstart
pip install apispec-webframeworks
from apispec_webframeworks.flask import FlaskPlugin
from apispec import APISpec
spec = APISpec(
title="API",
version="1.0.0",
plugins=[FlaskPlugin()],
)Verify before relying
- Whether all four framework plugins (aiohttp, bottle, flask, tornado) are production-ready or have known limitations
- Performance impact when generating specs for large applications with many routes
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.8 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packageapispec |
| Maintenance | Actively maintained 697 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 627,434 / month, #5,682 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseNatural Language :: EnglishProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9 |
Evidence: apispec_webframeworks-1.2.0-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 › “apispec web framework plugins”
- apispec-webframeworksProvides web framework plugins for apispec to automatically generate…
- apispecGenerates OpenAPI specification documents from Python code,…
- apispec-oneofschemaExtends apispec to generate OpenAPI 3.0+ documentation for…
Give your agent the search over MCP, or paste the wish link into any chat.
More Application Frameworks packages
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Textual is a Python framework for building cross-platform user interfaces that run in the terminal or web browser using a modern, component-based API.
Install it if you're developing CLI tools, dashboards, or interactive terminal applications.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Build and connect to Model Context Protocol servers that expose tools, resources, and prompts to LLM applications over stdio, HTTP, or SSE transports.
Install it if you need to build or connect to servers.
Werkzeug is a WSGI utility library providing request/response objects, URL routing, an interactive debugger, HTTP utilities, and a development server for building web applications.
See also apispec · webargs · flask-apispec · apispec-oneofschema · flask-openapi3 · swagger-ui-py · APIFlask · flasgger · flask-marshmallow · flask-pydantic-spec