openapi-py-fetch

Lightweight Python OpenAPI 3.x → Python httpx client generator and runtime. Zero Java, zero npm — just Python 3.11+ and your OpenAPI spec.

A fast, single-package alternative to the 200MB+ Java openapi-generator-cli. Generates typed Python API classes backed by a shared httpx runtime.

Features

• OpenAPI 2.0 & 3.x — handles Swagger and OpenAPI specs
• Shared runtime — ApiClient, Configuration, and exceptions are a pip-installable library, not duplicated per project
• Thin generated output — only API classes are generated; they import from openapi_py_fetch
• No runtime duplication — unlike template-copy generators, the transport layer is maintained in one place
• Drop-in compatible — generated openapi_client package structure matches openapi-generator output

Installation

pip install openapi-py-fetch

Usage

As a CLI

# Generate client from local spec
openapi-py-fetch openapi.json ./generated_openapi

# Generate from URL
openapi-py-fetch https://petstore.swagger.io/v2/swagger.json ./generated_openapi

# Generate only specific tags
openapi-py-fetch openapi.json ./generated_openapi --tags pet,store

# Dry run — validate and preview without writing files
openapi-py-fetch openapi.json --dry-run

# Check version
openapi-py-fetch --version

As a library (runtime)

from openapi_py_fetch import ApiClient, Configuration, ApiException

config = Configuration(
    host="https://petstore.swagger.io/v2",
    api_key={"api_key": "special-key"},
)
client = ApiClient(configuration=config)

As a library (generator)

from openapi_py_fetch.generator import generate_client_package
from pathlib import Path
import json

with open("openapi.json") as f:
    spec = json.load(f)

generate_client_package(spec, Path("generated_openapi"))

Generated Output Structure

generated_openapi/
├── pyproject.toml          # depends on openapi-py-fetch
└── openapi_client/
    ├── __init__.py          # re-exports runtime + API classes
    ├── api/
    │   ├── __init__.py
    │   ├── pet_api.py       # thin typed wrapper
    │   ├── store_api.py
    │   └── user_api.py
    └── models/
        └── __init__.py      # stub (schemas are inline)

Comparison with openapi-ts-fetch

	openapi-py-fetch	openapi-ts-fetch
Language	Python 3.11+	TypeScript
HTTP transport	httpx	fetch
Runtime	Shared pip package	Copied template file
Generated output	Python classes	TypeScript classes
Models	Inline (dict)	Full interfaces + JSON converters

License

MIT — Max Health Inc.