https://github.com/bottlepy/bottle

bottle.py is a fast and simple micro-framework for python web-applications.
https://github.com/bottlepy/bottle

bottle python rest web-framework wsgi

Last synced: 3 months ago
JSON representation

bottle.py is a fast and simple micro-framework for python web-applications.

• Host: GitHub
• URL: https://github.com/bottlepy/bottle
• Owner: bottlepy
• License: mit
• Created: 2009-06-30T17:51:30.000Z (over 16 years ago)
• Default Branch: master
• Last Pushed: 2025-04-23T08:22:11.000Z (8 months ago)
• Last Synced: 2025-04-24T00:38:54.348Z (8 months ago)
• Topics: bottle, python, rest, web-framework, wsgi
• Language: Python
• Homepage: http://bottlepy.org/
• Size: 6.33 MB
• Stars: 8,580
• Watchers: 305
• Forks: 1,485
• Open Issues: 282
• Metadata Files:
  • Readme: README.rst
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Authors: AUTHORS

Awesome Lists containing this project

• awesome-huzhi - bottle
• Self-Hosting-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools / In-memory data grids)
• Fuchsia-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools)
• Shopify-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools)
• NLP-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks, Libraries, and Tools)
• CUDA-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools)
• Firmware-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools)
• CoreML-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks, Libraries, and Tools)
• Robotics-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools)
• gpu-guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools)
• AWS-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools / Interfaces)
• awesome-starred - bottlepy/bottle - bottle.py is a fast and simple micro-framework for python web-applications. (python)
• Bioinformatics-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools)
• awesome-open-source-applications - Bottle - framework for Python. |  |  |  |  |  | (Back-End Development)
• best-of-web-python - GitHub - 30% open · ⏱️ 19.09.2025): (Web Frameworks)
• zero - bottle - framework for web-applications | Python | MIT | (Members)
• Virtualization-Emulation-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools / Interfaces)
• IoT-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools / In-memory data grids)
• awesome-python-web-frameworks - Bottle - a fast, simple and lightweight WSGI micro web-framework for Python. It is distributed as a single file module and has no dependencies other than the Python Standard Library. (Micro-frameworks / Sync)
• VMware-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools)
• PyTorch-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools)
• Apache-Spark-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools)
• TensorFlow-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools)
• Oracle-Cloud-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools)
• Blockchain-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools / E-Books)
• Android-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools / VS Code Extensions for Developer Productivity)
• Apache-Airflow-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools)
• macOS-iOS-iPadOS-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools / Objective-C Tools, Libraries, and Frameworks)
• ARM-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools)
• Apache-Kafka-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools)
• Jupyter-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools)
• Deep-Learning-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks, Libraries, and Tools / viii. Linear Regression)
• Computer-Vision-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks, Libraries, and Tools / viii. Linear Regression)
• Parallel-Computing-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools)
• Developer-Handbook - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Tools / Mesh networks)
• Autonomous-Systems-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks, Libraries, and Tools / viii. Linear Regression)
• VSCode-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Learning Resources / JavaScript Libraries for Machine Learning)
• Unreal-Engine-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks, Libraries, and Tools / viii. Linear Regression)
• Distributed-Systems-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools)
• ansible-guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks and Tools)
• Python-Guide - Bottle - framework for Python. It is distributed as a single file module and has no dependencies other than the [Python Standard Library](https://docs.python.org/library/). (Python Frameworks, Libraries, and Tools)

README

          
.. image:: http://bottlepy.org/docs/dev/_static/logo_nav.png

  :target: http://bottlepy.org/

  :alt: Bottle Logo

  :align: right

.. image:: https://github.com/bottlepy/bottle/workflows/Tests/badge.svg

    :target: https://github.com/bottlepy/bottle/workflows/Tests

    :alt: Tests Status

.. image:: https://img.shields.io/pypi/v/bottle.svg

    :target: https://pypi.python.org/pypi/bottle/

    :alt: Latest Version

.. image:: https://img.shields.io/pypi/l/bottle.svg

    :target: https://pypi.python.org/pypi/bottle/

    :alt: License

.. _Python: https://python.org/

.. _mako: https://www.makotemplates.org/

.. _cheetah: https://www.cheetahtemplate.org/

.. _jinja2: https://jinja.palletsprojects.com/

.. _WSGI: https://peps.python.org/pep-3333/

.. _gunicorn: https://gunicorn.org/

.. _paste: https://pythonpaste.readthedocs.io/

.. _cheroot: https://cheroot.cherrypy.dev/

============================

Bottle: Python Web Framework

============================

Bottle is a fast, simple and lightweight WSGI_ micro web-framework for Python_. It is distributed as a single file module and has no dependencies other than the `Python Standard Library `_.

* **Routing:** Requests to function-call mapping with support for clean and dynamic URLs.

* **Templates:** Fast `built-in template engine `_ and support for mako_, jinja2_ and cheetah_ templates.

* **Utilities:** Convenient access to form data, file uploads, cookies, headers and other HTTP features.

* **Server:** Built-in development server and ready-to-use adapters for a wide range of WSGI_ capable HTTP server (e.g. gunicorn_, paste_ or cheroot_).

Homepage and documentation: http://bottlepy.org

Example: "Hello World" in a bottle

----------------------------------

.. code-block:: python

  from bottle import route, run, template

  @route('/hello/')

  def index(name):

      return template('Hello {{name}}!', name=name)

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

Run this script or paste it into a Python console, then point your browser to ``_. That's it.

Download and Install

--------------------

.. __: https://github.com/bottlepy/bottle/raw/master/bottle.py

Install the latest stable release with ``pip install bottle`` or download `bottle.py`__ (unstable) into your project directory. There are no hard dependencies other than the Python standard library.

License

-------

.. __: https://github.com/bottlepy/bottle/raw/master/LICENSE

Code and documentation are available according to the MIT License (see LICENSE__).

The Bottle logo however is *NOT* covered by that license. It is allowed to use the logo as a link to the bottle homepage or in direct context with the unmodified library. In all other cases, please ask first.