https://github.com/beeware/toga

A Python native, OS native GUI toolkit.
https://github.com/beeware/toga

Last synced: 6 months ago
JSON representation

A Python native, OS native GUI toolkit.

• Host: GitHub
• URL: https://github.com/beeware/toga
• Owner: beeware
• License: bsd-3-clause
• Created: 2014-08-01T21:44:10.000Z (over 11 years ago)
• Default Branch: main
• Last Pushed: 2025-05-05T03:35:36.000Z (6 months ago)
• Last Synced: 2025-05-06T19:51:56.226Z (6 months ago)
• Language: Python
• Homepage: https://toga.readthedocs.io/en/latest/
• Size: 33.7 MB
• Stars: 4,868
• Watchers: 88
• Forks: 714
• Open Issues: 273
• Metadata Files:
  • Readme: README.rst
  • Changelog: changes/2851.feature.rst
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-list - Toga - A Python native, OS native GUI toolkit. (Desktop App Development / Python Toolkit)
• awesome-starred - beeware/toga - A Python native, OS native GUI toolkit. (Python)
• awesome-starred - beeware/toga - A Python native, OS native GUI toolkit. (Python)
• best-of-python - GitHub - 24% open · ⏱️ 23.10.2025): (GUI Development)
• awesome-python-resources - GitHub - 17% open · ⏱️ 26.08.2022): (图形用户界面)

README

          
.. |logo| image:: https://beeware.org/project/toga/toga.png

    :width: 72px

    :target: https://beeware.org/toga

.. |pyversions| image:: https://img.shields.io/pypi/pyversions/toga.svg

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

    :alt: Python Versions

.. |version| image:: https://img.shields.io/pypi/v/toga.svg

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

    :alt: Project version

.. |maturity| image:: https://img.shields.io/pypi/status/toga.svg

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

    :alt: Project status

.. |license| image:: https://img.shields.io/pypi/l/toga.svg

    :target: https://github.com/beeware/toga/blob/main/LICENSE

    :alt: BSD License

.. |ci| image:: https://github.com/beeware/toga/workflows/CI/badge.svg?branch=main

   :target: https://github.com/beeware/toga/actions

   :alt: Build Status

.. |social| image:: https://img.shields.io/discord/836455665257021440?label=Discord%20Chat&logo=discord&style=plastic

   :target: https://beeware.org/bee/chat/

   :alt: Discord server

|logo|

Toga

====

|pyversions| |version| |maturity| |license| |ci| |social|

A Python native, OS native GUI toolkit.

Minimum requirements

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

* Toga requires **Python 3.9 or higher**.

* If you're on macOS, you need to be on 11 (Big Sur) or newer.

* If you're on Windows, you'll need Windows 10 or newer. If you are using

  Windows 10 and want to use a WebView to display web content, you will also

  need to install the `Edge WebView2 Evergreen Runtime

  `__.

  Windows 11 has this runtime installed by default.

* If you're on Linux (or another Unix-based operating system), you need to have

  GTK+ >= 3.24 and glib >= 2.64. These are available starting with Ubuntu 20.04 and

  Fedora 32. You also need to install the system packages listed in `Linux platform

  documentation `__.

Quickstart

----------

To get a demonstration of the capabilities of Toga, run the following::

    $ pip install toga-demo

    $ toga-demo

This will pop up a GUI window with some sample widgets.

Documentation

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

Documentation for Toga can be found on `Read The Docs`_.

.. _Read The Docs: https://toga.readthedocs.io

Financial support

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

The BeeWare project would not be possible without the generous support of our financial

members:

.. image:: https://beeware.org/community/members/anaconda/anaconda-large.png

    :target: https://anaconda.com/

    :alt: Anaconda logo

Anaconda Inc. - Advancing AI through open source.

Plus individual contributions from `users like you

`__. If you find Toga, or other BeeWare tools

useful, please consider becoming a financial member.

Community

---------

Toga is part of the `BeeWare suite`_. You can talk to the community through:

* `@beeware@fosstodon.org on Mastodon`_

* `Discord`_

* The Toga `Github Discussions forum`_

We foster a welcoming and respectful community as described in our

`BeeWare Community Code of Conduct`_.

.. _BeeWare suite: https://beeware.org

.. _@beeware@fosstodon.org on Mastodon: https://fosstodon.org/@beeware

.. _Discord: https://beeware.org/bee/chat/

.. _Github Discussions forum: https://github.com/beeware/toga/discussions

.. _BeeWare Community Code of Conduct: https://beeware.org/community/behavior/

Contributing

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

If you experience problems with Toga, `log them on GitHub

`__.

If you'd like to contribute to Toga development, our `contribution guide

`__

details how to set up a development environment, and other requirements we have

as part of our contribution process.