<a href="https://nicegui.io/#about">
<img src="https://raw.githubusercontent.com/zauberzeug/nicegui/main/screenshot.png"
width="200" align="right" alt="Try online!" />
</a>
# NiceGUI
NiceGUI is an easy-to-use, Python-based UI framework, which shows up in your web browser.
You can create buttons, dialogs, Markdown, 3D scenes, plots and much more.
It is great for micro web apps, dashboards, robotics projects, smart home solutions and similar use cases.
You can also use it in development, for example when tweaking/configuring a machine learning algorithm or tuning motor controllers.
NiceGUI is available as [PyPI package](https://pypi.org/project/nicegui/), [Docker image](https://hub.docker.com/r/zauberzeug/nicegui) and on [conda-forge](https://anaconda.org/conda-forge/nicegui) as well as [GitHub](https://github.com/zauberzeug/nicegui).
[](https://pypi.org/project/nicegui/)
[](https://pypi.org/project/nicegui/)
[](https://anaconda.org/conda-forge/nicegui)
[](https://anaconda.org/conda-forge/nicegui)
[](https://hub.docker.com/r/zauberzeug/nicegui)<br />
[](https://github.com/zauberzeug/nicegui/blob/main/LICENSE)
[](https://github.com/zauberzeug/nicegui/graphs/commit-activity)
[](https://github.com/zauberzeug/nicegui/issues)
[](https://github.com/zauberzeug/nicegui/network)
[](https://github.com/zauberzeug/nicegui/stargazers)
## Features
- browser-based graphical user interface
- implicit reload on code change
- acts as webserver (accessed by the browser) or in native mode (eg. desktop window)
- standard GUI elements like label, button, checkbox, switch, slider, input, file upload, ...
- simple grouping with rows, columns, cards and dialogs
- general-purpose HTML and Markdown elements
- powerful high-level elements to
- plot graphs and charts,
- render 3D scenes,
- get steering events via virtual joysticks
- annotate and overlay images
- interact with tables
- navigate foldable tree structures
- embed video and audio files
- built-in timer to refresh data in intervals (even every 10 ms)
- straight-forward data binding and refreshable functions to write even less code
- notifications, dialogs and menus to provide state of the art user interaction
- shared and individual web pages
- easy-to-use per-user and general persistence
- ability to add custom routes and data responses
- capture keyboard input for global shortcuts etc.
- customize look by defining primary, secondary and accent colors
- live-cycle events and session data
- runs in Jupyter Notebooks and allows Python's interactive mode
- auto-complete support for Tailwind CSS
- SVG, Base64 and emoji favicon support
- testing framework based on pytest
## Installation
```bash
python3 -m pip install nicegui
```
## Usage
Write your nice GUI in a file `main.py`:
```python
from nicegui import ui
ui.label('Hello NiceGUI!')
ui.button('BUTTON', on_click=lambda: ui.notify('button was pressed'))
ui.run()
```
Launch it with:
```bash
python3 main.py
```
The GUI is now available through http://localhost:8080/ in your browser.
Note: NiceGUI will automatically reload the page when you modify the code.
## Documentation and Examples
The documentation is hosted at [https://nicegui.io/documentation](https://nicegui.io/documentation) and provides plenty of live demos.
The whole content of [https://nicegui.io](https://nicegui.io) is [implemented with NiceGUI itself](https://github.com/zauberzeug/nicegui/blob/main/main.py)
and can be started locally with `docker run -p 8080:8080 zauberzeug/nicegui` or by executing `main.py` from this repository.
You may also have a look at our [in-depth examples](https://github.com/zauberzeug/nicegui/tree/main/examples) of what you can do with NiceGUI.
In our wiki we have a list of great [NiceGUI projects from the community](https://github.com/zauberzeug/nicegui/wiki#community-projects), a section with [Tutorials](https://github.com/zauberzeug/nicegui/wiki#tutorials), a growing list of [FAQs](https://github.com/zauberzeug/nicegui/wiki/FAQs) and [some strategies for using ChatGPT / LLMs to get help about NiceGUI](https://github.com/zauberzeug/nicegui/wiki#chatgpt).
## Why?
We at [Zauberzeug](https://zauberzeug.com) like [Streamlit](https://streamlit.io/)
but find it does [too much magic](https://github.com/zauberzeug/nicegui/issues/1#issuecomment-847413651) when it comes to state handling.
In search for an alternative nice library to write simple graphical user interfaces in Python we discovered [JustPy](https://justpy.io/).
Although we liked the approach, it is too "low-level HTML" for our daily usage.
But it inspired us to use [Vue](https://vuejs.org/) and [Quasar](https://quasar.dev/) for the frontend.
We have built on top of [FastAPI](https://fastapi.tiangolo.com/),
which itself is based on the ASGI framework [Starlette](https://www.starlette.io/)
and the ASGI webserver [Uvicorn](https://www.uvicorn.org/)
because of their great performance and ease of use.
## Sponsors
Maintenance of this project is made possible by all the [contributors](https://github.com/zauberzeug/nicegui/graphs/contributors) and [sponsors](https://github.com/sponsors/zauberzeug).
If you would like to support this project and have your avatar or company logo appear below, please [sponsor us](https://github.com/sponsors/zauberzeug). 💖
<!-- SPONSORS -->
<p align="center">
<a href="https://github.com/lechler-gmbh"><img src="https://github.com/lechler-gmbh.png" width="50px" alt="Lechler GmbH" /></a>
<a href="https://github.com/Zhifeng2019"><img src="https://github.com/Zhifeng2019.png" width="50px" alt="Zhifeng" /></a>
<a href="https://github.com/sereneturtlefox"><img src="https://github.com/sereneturtlefox.png" width="50px" alt="None" /></a>
<a href="https://github.com/daviborges666"><img src="https://github.com/daviborges666.png" width="50px" alt="Davi Borges" /></a>
<a href="https://github.com/whoulden"><img src="https://github.com/whoulden.png" width="50px" alt="Wayne Houlden" /></a>
<a href="https://github.com/digiquip"><img src="https://github.com/digiquip.png" width="50px" alt="DigiQuip AS" /></a>
</p>
<!-- SPONSORS -->
Consider this low-barrier form of contribution yourself.
Your [support](https://github.com/sponsors/zauberzeug) is much appreciated.
## Contributing
Thank you for your interest in contributing to NiceGUI! We are thrilled to have you on board and appreciate your efforts to make this project even better.
As a growing open-source project, we understand that it takes a community effort to achieve our goals. That's why we welcome all kinds of contributions, no matter how small or big they are. Whether it's adding new features, fixing bugs, improving documentation, or suggesting new ideas, we believe that every contribution counts and adds value to our project.
We have provided a detailed guide on how to contribute to NiceGUI in our [CONTRIBUTING.md](https://github.com/zauberzeug/nicegui/blob/main/CONTRIBUTING.md) file. We encourage you to read it carefully before making any contributions to ensure that your work aligns with the project's goals and standards.
If you have any questions or need help with anything, please don't hesitate to reach out to us. We are always here to support and guide you through the contribution process.
## Included Web Dependencies
See [DEPENDENCIES.md](https://github.com/zauberzeug/nicegui/blob/main/DEPENDENCIES.md) for a list of web frameworks NiceGUI depends on.
Raw data
{
"_id": null,
"home_page": "https://github.com/zauberzeug/nicegui",
"name": "nicegui",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.8",
"maintainer_email": null,
"keywords": "gui, ui, web, interface, live",
"author": "Zauberzeug GmbH",
"author_email": "info@zauberzeug.com",
"download_url": "https://files.pythonhosted.org/packages/4b/62/31a24a5c71cf6f831525df8317e50dcaeb9cb83f10d7acce6747f9284ade/nicegui-2.8.0.tar.gz",
"platform": null,
"description": "<a href=\"https://nicegui.io/#about\">\n <img src=\"https://raw.githubusercontent.com/zauberzeug/nicegui/main/screenshot.png\"\n width=\"200\" align=\"right\" alt=\"Try online!\" />\n</a>\n\n# NiceGUI\n\nNiceGUI is an easy-to-use, Python-based UI framework, which shows up in your web browser.\nYou can create buttons, dialogs, Markdown, 3D scenes, plots and much more.\n\nIt is great for micro web apps, dashboards, robotics projects, smart home solutions and similar use cases.\nYou can also use it in development, for example when tweaking/configuring a machine learning algorithm or tuning motor controllers.\n\nNiceGUI is available as [PyPI package](https://pypi.org/project/nicegui/), [Docker image](https://hub.docker.com/r/zauberzeug/nicegui) and on [conda-forge](https://anaconda.org/conda-forge/nicegui) as well as [GitHub](https://github.com/zauberzeug/nicegui).\n\n[](https://pypi.org/project/nicegui/)\n[](https://pypi.org/project/nicegui/)\n[](https://anaconda.org/conda-forge/nicegui)\n[](https://anaconda.org/conda-forge/nicegui)\n[](https://hub.docker.com/r/zauberzeug/nicegui)<br />\n[](https://github.com/zauberzeug/nicegui/blob/main/LICENSE)\n[](https://github.com/zauberzeug/nicegui/graphs/commit-activity)\n[](https://github.com/zauberzeug/nicegui/issues)\n[](https://github.com/zauberzeug/nicegui/network)\n[](https://github.com/zauberzeug/nicegui/stargazers)\n\n## Features\n\n- browser-based graphical user interface\n- implicit reload on code change\n- acts as webserver (accessed by the browser) or in native mode (eg. desktop window)\n- standard GUI elements like label, button, checkbox, switch, slider, input, file upload, ...\n- simple grouping with rows, columns, cards and dialogs\n- general-purpose HTML and Markdown elements\n- powerful high-level elements to\n - plot graphs and charts,\n - render 3D scenes,\n - get steering events via virtual joysticks\n - annotate and overlay images\n - interact with tables\n - navigate foldable tree structures\n - embed video and audio files\n- built-in timer to refresh data in intervals (even every 10 ms)\n- straight-forward data binding and refreshable functions to write even less code\n- notifications, dialogs and menus to provide state of the art user interaction\n- shared and individual web pages\n- easy-to-use per-user and general persistence\n- ability to add custom routes and data responses\n- capture keyboard input for global shortcuts etc.\n- customize look by defining primary, secondary and accent colors\n- live-cycle events and session data\n- runs in Jupyter Notebooks and allows Python's interactive mode\n- auto-complete support for Tailwind CSS\n- SVG, Base64 and emoji favicon support\n- testing framework based on pytest\n\n## Installation\n\n```bash\npython3 -m pip install nicegui\n```\n\n## Usage\n\nWrite your nice GUI in a file `main.py`:\n\n```python\nfrom nicegui import ui\n\nui.label('Hello NiceGUI!')\nui.button('BUTTON', on_click=lambda: ui.notify('button was pressed'))\n\nui.run()\n```\n\nLaunch it with:\n\n```bash\npython3 main.py\n```\n\nThe GUI is now available through http://localhost:8080/ in your browser.\nNote: NiceGUI will automatically reload the page when you modify the code.\n\n## Documentation and Examples\n\nThe documentation is hosted at [https://nicegui.io/documentation](https://nicegui.io/documentation) and provides plenty of live demos.\nThe whole content of [https://nicegui.io](https://nicegui.io) is [implemented with NiceGUI itself](https://github.com/zauberzeug/nicegui/blob/main/main.py)\nand can be started locally with `docker run -p 8080:8080 zauberzeug/nicegui` or by executing `main.py` from this repository.\n\nYou may also have a look at our [in-depth examples](https://github.com/zauberzeug/nicegui/tree/main/examples) of what you can do with NiceGUI.\nIn our wiki we have a list of great [NiceGUI projects from the community](https://github.com/zauberzeug/nicegui/wiki#community-projects), a section with [Tutorials](https://github.com/zauberzeug/nicegui/wiki#tutorials), a growing list of [FAQs](https://github.com/zauberzeug/nicegui/wiki/FAQs) and [some strategies for using ChatGPT / LLMs to get help about NiceGUI](https://github.com/zauberzeug/nicegui/wiki#chatgpt).\n\n## Why?\n\nWe at [Zauberzeug](https://zauberzeug.com) like [Streamlit](https://streamlit.io/)\nbut find it does [too much magic](https://github.com/zauberzeug/nicegui/issues/1#issuecomment-847413651) when it comes to state handling.\nIn search for an alternative nice library to write simple graphical user interfaces in Python we discovered [JustPy](https://justpy.io/).\nAlthough we liked the approach, it is too \"low-level HTML\" for our daily usage.\nBut it inspired us to use [Vue](https://vuejs.org/) and [Quasar](https://quasar.dev/) for the frontend.\n\nWe have built on top of [FastAPI](https://fastapi.tiangolo.com/),\nwhich itself is based on the ASGI framework [Starlette](https://www.starlette.io/)\nand the ASGI webserver [Uvicorn](https://www.uvicorn.org/)\nbecause of their great performance and ease of use.\n\n## Sponsors\n\nMaintenance of this project is made possible by all the [contributors](https://github.com/zauberzeug/nicegui/graphs/contributors) and [sponsors](https://github.com/sponsors/zauberzeug).\nIf you would like to support this project and have your avatar or company logo appear below, please [sponsor us](https://github.com/sponsors/zauberzeug). \ud83d\udc96\n\n<!-- SPONSORS -->\n<p align=\"center\">\n <a href=\"https://github.com/lechler-gmbh\"><img src=\"https://github.com/lechler-gmbh.png\" width=\"50px\" alt=\"Lechler GmbH\" /></a>\n <a href=\"https://github.com/Zhifeng2019\"><img src=\"https://github.com/Zhifeng2019.png\" width=\"50px\" alt=\"Zhifeng\" /></a>\n <a href=\"https://github.com/sereneturtlefox\"><img src=\"https://github.com/sereneturtlefox.png\" width=\"50px\" alt=\"None\" /></a>\n <a href=\"https://github.com/daviborges666\"><img src=\"https://github.com/daviborges666.png\" width=\"50px\" alt=\"Davi Borges\" /></a>\n <a href=\"https://github.com/whoulden\"><img src=\"https://github.com/whoulden.png\" width=\"50px\" alt=\"Wayne Houlden\" /></a>\n <a href=\"https://github.com/digiquip\"><img src=\"https://github.com/digiquip.png\" width=\"50px\" alt=\"DigiQuip AS\" /></a>\n</p>\n<!-- SPONSORS -->\n\nConsider this low-barrier form of contribution yourself.\nYour [support](https://github.com/sponsors/zauberzeug) is much appreciated.\n\n## Contributing\n\nThank you for your interest in contributing to NiceGUI! We are thrilled to have you on board and appreciate your efforts to make this project even better.\n\nAs a growing open-source project, we understand that it takes a community effort to achieve our goals. That's why we welcome all kinds of contributions, no matter how small or big they are. Whether it's adding new features, fixing bugs, improving documentation, or suggesting new ideas, we believe that every contribution counts and adds value to our project.\n\nWe have provided a detailed guide on how to contribute to NiceGUI in our [CONTRIBUTING.md](https://github.com/zauberzeug/nicegui/blob/main/CONTRIBUTING.md) file. We encourage you to read it carefully before making any contributions to ensure that your work aligns with the project's goals and standards.\n\nIf you have any questions or need help with anything, please don't hesitate to reach out to us. We are always here to support and guide you through the contribution process.\n\n## Included Web Dependencies\n\nSee [DEPENDENCIES.md](https://github.com/zauberzeug/nicegui/blob/main/DEPENDENCIES.md) for a list of web frameworks NiceGUI depends on.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Create web-based user interfaces with Python. The nice way.",
"version": "2.8.0",
"project_urls": {
"Homepage": "https://github.com/zauberzeug/nicegui",
"Repository": "https://github.com/zauberzeug/nicegui"
},
"split_keywords": [
"gui",
" ui",
" web",
" interface",
" live"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b661ea3667d4327b35584f01c51af08e8e6c9a356399f7e14318722bf73b9d95",
"md5": "6ebdadf999055a36987fa966f4163b9d",
"sha256": "e46c4a2659f8526fe0216dd51c5c02c3c5f4b6bbd7c2c2edc7abc3807007322a"
},
"downloads": -1,
"filename": "nicegui-2.8.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6ebdadf999055a36987fa966f4163b9d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.8",
"size": 16468322,
"upload_time": "2024-12-05T09:47:20",
"upload_time_iso_8601": "2024-12-05T09:47:20.565597Z",
"url": "https://files.pythonhosted.org/packages/b6/61/ea3667d4327b35584f01c51af08e8e6c9a356399f7e14318722bf73b9d95/nicegui-2.8.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4b6231a24a5c71cf6f831525df8317e50dcaeb9cb83f10d7acce6747f9284ade",
"md5": "540ccacd2a2ccf1c386530bb1e921b6a",
"sha256": "78d365bffe9f8fc5a61e14a833ca7ffa6aaba61ae9e15d91e6d5a1cada5a7f40"
},
"downloads": -1,
"filename": "nicegui-2.8.0.tar.gz",
"has_sig": false,
"md5_digest": "540ccacd2a2ccf1c386530bb1e921b6a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8",
"size": 16054395,
"upload_time": "2024-12-05T09:47:24",
"upload_time_iso_8601": "2024-12-05T09:47:24.304431Z",
"url": "https://files.pythonhosted.org/packages/4b/62/31a24a5c71cf6f831525df8317e50dcaeb9cb83f10d7acce6747f9284ade/nicegui-2.8.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-05 09:47:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "zauberzeug",
"github_project": "nicegui",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "nicegui"
}
JSON
