aiopenapi3
client and validator for OpenAPI3 3.0, OpenAPI 3.1, OpenAPI 3.2, Swagger 2.0
Decision gist · record as of 2026-08-14
Yes, if you need to work with OpenAPI or Swagger specs in Python. Low install friction, active maintenance, no vulnerabilities, and permissive licensing make it a safe choice. The Alpha status is worth noting—it's suitable for production use but may see API changes; check the docs for stability guarantees. The 10 runtime dependencies are well-established (pydantic, httpx, PyYAML, etc.), so dependency risk is low.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later; async usage requires an asyncio event loop.
- Low friction: pure Python wheel with no compiled dependencies.
- Active maintenance (last commit 2026-08-11) and no known vulnerabilities.
License · maintenance · safety
BSD-3-Clause (permissive) — BSD-3-Clause (permissive): you may use, modify, and distribute this package freely in commercial and private projects, provided you retain the license notice.
last release 2026-05-01 (105 days) · last repo commit 2026-08-11 · 20 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 333,861 downloads/mo, #7,497 on PyPI
Alternatives
Verify before relying
pip install aiopenapi3
import aiopenapi3
# Load and validate an OpenAPI spec
spec = aiopenapi3.OpenAPI.load_sync('https://example.com/openapi.json')
# Call an endpoint with typed validation
response = spec.call_sync('operationId', param=value)- Whether the 'sad smiley ._. interface' for method/argument access is stable or experimental.
- Performance characteristics when validating large or deeply nested OpenAPI documents.
- Support for OpenAPI extensions and vendor-specific fields beyond the core spec.
What it is and what it does
aiopenapi3 is a Python client library that reads OpenAPI 3 and Swagger 2.0 specification documents, validates them using pydantic, and generates typed request and response models. It then provides both synchronous and asynchronous HTTP clients (via httpx) to call the described APIs with full type checking and validation. The library handles recursive schemas, format coercion (e.g., datetime parsing), and response header parsing.
You use it by loading a spec from a URL or file, then calling endpoints by operation ID with parameters that are automatically validated against the schema. The library supports both blocking and asyncio-based async calls, includes a plugin interface for adapting non-compliant services, and can download dependent specification documents. It's currently in Alpha status but actively maintained, with no known security vulnerabilities.
Use it for
- Generate a type-safe Python client from a published OpenAPI spec without hand-writing request/response classes.
- Validate incoming API requests and responses against an OpenAPI schema in a test suite or integration layer.
- Build async microservice clients that automatically parse and coerce response bodies according to the spec.
- Adapt third-party APIs with non-standard OpenAPI documents using the plugin interface.
- Consume Swagger 2.0 or OpenAPI 3.x specs in a single codebase with automatic format handling.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to work with OpenAPI or Swagger specs in Python.
Low install friction, active maintenance, no vulnerabilities, and permissive licensing make it a safe choice. The Alpha status is worth noting—it's suitable for production use but may see API changes; check the docs for stability guarantees. The 10 runtime dependencies are well-established (pydantic, httpx, PyYAML, etc.), so dependency risk is low.
Install
aiopenapi3 on PyPI
Before you install
Low friction: pure Python wheel with no compiled dependencies. Active maintenance (last commit 2026-08-11) and no known vulnerabilities. Requires Python 3.10 or later.
Requires Python 3.10 or later; async usage requires an asyncio event loop.
License in practice
BSD-3-Clause (permissive): you may use, modify, and distribute this package freely in commercial and private projects, provided you retain the license notice.
Quickstart
pip install aiopenapi3
import aiopenapi3
# Load and validate an OpenAPI spec
spec = aiopenapi3.OpenAPI.load_sync('https://example.com/openapi.json')
# Call an endpoint with typed validation
response = spec.call_sync('operationId', param=value)Verify before relying
- Whether the 'sad smiley ._. interface' for method/argument access is stable or experimental.
- Performance characteristics when validating large or deeply nested OpenAPI documents.
- Support for OpenAPI extensions and vendor-specific fields beyond the core spec.
Package facts
| License | BSD-3-Clause permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 10 packagesPyYamlpydanticemail-validatoryarlhttpxmore-itertoolstyping_extensionsjmespathijsonjsonseq |
| Maintenance | Actively maintained 105 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 333,861 / month, #7,497 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 3 - AlphaEnvironment :: Web EnvironmentFramework :: AsyncIOIntended Audience :: DevelopersIntended Audience :: Information TechnologyIntended Audience :: System AdministratorsLicense :: OSI Approved :: BSD LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: InternetTopic :: Internet :: WWW/HTTPTopic :: Software DevelopmentTopic :: Software Development :: LibrariesTopic :: Software Development :: Libraries :: Application FrameworksTopic :: Software Development :: Libraries :: Python ModulesTyping :: Typed |
Evidence: aiopenapi3-0.10.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 › “typed http client from openapi”
- aiopenapi3Parses and validates OpenAPI 3 specifications (3.0.3, 3.1.0, 3.2.0)…
- turnkey-httpTurnkey HTTP is an HTTP client for the Turnkey API that provides…
- openapi-python-clientGenerates type-annotated Python HTTP clients from OpenAPI 3.0 and 3.1…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
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.
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.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also openapi3 · openapi-spec-validator · openapi-core · flask-openapi3 · openapi-schema-pydantic · apispec · prance · swagger-spec-validator · openapi-schema-validator · flask-pydantic-spec