---
id: bottle
version: "0.13.4"
license: MIT
license_treatment: permissive
maintenance: active
---

# bottle — Fast and simple WSGI-framework for small web-applications.

License: permissive · Maintenance: active · Downloads: 11.3M/mo

## What it is and what it does

Bottle is a single-file WSGI microframework designed for small web applications. It bundles routing, templating, and HTTP utilities into one module with zero external dependencies, making it quick to install and deploy. The framework handles URL mapping to functions, provides a built-in template engine, and can integrate with external template engines. It includes a development server and works with standard WSGI servers for production use.

The framework is aimed at developers who want a minimal, self-contained tool for web development without overhead. Its single-file distribution and lack of dependencies make it portable and suitable for embedded use or rapid prototyping. It supports Python 2.7 and Python 3.8 through 3.13, though the project is classified as Beta status.

Use it for:

- Build a small REST API or web service that needs routing and HTTP utilities without framework overhead.
- Prototype a web application quickly using the built-in development server and template engine.
- Embed a lightweight HTTP interface into an existing Python application or tool.
- Create a simple web application that runs on constrained environments where minimal dependencies matter.
- Serve templated HTML responses with form data handling and cookie management.

## Worth the install?

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

Bottle is a lightweight WSGI microframework for building web applications in Python, providing routing, templating, and HTTP utilities with no external dependencies beyond the standard library.

Yes, if you need a lightweight, dependency-free web framework for small projects or prototyping. The permissive MIT license, active repository, and zero external dependencies make it low-risk to adopt. Verify the project's maintenance cadence for production use before committing.

## Install

pip install bottle
uv add bottle
poetry add bottle

## Installing bottle

Before you install: Installation is straightforward with no runtime dependencies. The project is actively maintained with recent commits and a large repository following.

License in practice: MIT license permits commercial and private use with minimal restrictions; you must include the license text but face no copyleft obligations.

Quickstart:

pip install bottle

from bottle import route, run

@route('/hello/')
def index(name):
    return 'Hello ' + name

run(host='localhost', port=8080)

Verify before relying:

- Whether the 425-day gap since the last release reflects maintenance dormancy or stable code requiring infrequent updates.
- Performance characteristics under production load compared to other microframeworks.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 11.3M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

lightweight python web framework, wsgi microframework, simple web routing, python http server, minimal web application, bottle web framework, single-file web framework, microframework, wsgi, zero-dependencies

[View on SkillFed](https://skillfed.io/packages/bottle) · [View on PyPI](https://pypi.org/project/bottle/)