---
id: swagger-ui-bundle
version: "1.1.0"
license: Apache-2.0
license_treatment: permissive
maintenance: aging
---

# swagger-ui-bundle — Swagger UI bundled for usage with Python

License: permissive · Maintenance: aging · Downloads: 3.5M/mo

## What it is and what it does

swagger-ui-bundle packages the static files from the Swagger UI project into a Python distribution, making it easy to integrate interactive API documentation into web applications without manually managing external assets. It includes Jinja2 templating support for basic configuration, allowing developers to customize the UI through template variables rather than modifying static files directly.

The package is webserver-agnostic and designed to work with any Python web framework. You import swagger_ui_path to get the directory containing all the UI assets, then serve them through your framework's static file mechanism. Configuration options like the OpenAPI spec URL can be templated and rendered on demand using Jinja2.

Use it for:

- Serve Swagger UI documentation alongside a REST API without managing external CDN dependencies
- Customize API documentation appearance by rendering Jinja2 templates with application-specific configuration
- Bundle interactive API docs into a self-contained Python application for offline or internal deployment
- Quickly prototype an API with live documentation by serving the static bundle through a web framework

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Packages Swagger UI's static files and templates as a Python distribution, allowing web frameworks to serve interactive API documentation without bundling the files separately.

Yes, if you need to serve Swagger UI documentation from a Python web application. The package has low install friction, permissive Apache 2.0 licensing, and no known vulnerabilities. The aging maintenance status (1017 days since last release) is a minor concern but acceptable given that it's a stable wrapper around static assets rather than active-development code.

## Install

pip install swagger-ui-bundle
uv add swagger-ui-bundle
poetry add swagger-ui-bundle

## Installing swagger-ui-bundle

Before you install: Low install friction with only two lightweight runtime dependencies (Jinja2 and importlib_resources). The package is aging (1017 days since last release) but remains in production/stable status with an active repository.

License in practice: Licensed under Apache 2.0, a permissive open-source license that allows commercial use, modification, and distribution with minimal restrictions.

Quickstart:

from swagger_ui_bundle import swagger_ui_path
import Jinja2

# swagger_ui_path points to the directory containing static UI files
# Render templates with Jinja2 for configuration
template_vars = {"openapi_spec_url": "https://example.com/spec.json"}
# Serve swagger_ui_path as static files through your web framework

Verify before relying:

- Whether the bundled Swagger UI version is current relative to upstream swagger-ui releases
- Performance characteristics when serving to high-traffic API documentation endpoints
- Specific web framework integration patterns beyond the documented example

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 3.5M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

swagger ui static files python, api documentation ui bundle, swagger ui integration, openapi spec viewer, rest api docs server, api-documentation, swagger-openapi

[View on SkillFed](https://skillfed.io/packages/swagger-ui-bundle) · [View on PyPI](https://pypi.org/project/swagger-ui-bundle/)