bottle

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 on this page — 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

bottle on PyPI

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

Evidence: bottle-0.13.4-py2.py3-none-any.whl

Tags

More Application Frameworks packages