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, Docker image and on conda-forge as well as GitHub.

Features

• browser-based graphical user interface
• implicit reload on code change
• acts as webserver (accessed by the browser) or in native mode (e.g. 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
  • show interactive maps
  • edit code, JSON and rich text
  • 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)
• straightforward data binding and refreshable functions to write even less code
• notifications, dialogs and menus to provide state-of-the-art user interaction
• multi-page and single-page applications
• 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, including dark mode
• lifecycle events and session data
• runs in Python's interactive mode
• styling with Tailwind CSS and Quasar
• SVG, Base64 and emoji favicon support
• testing framework based on pytest

Installation

python3 -m pip install nicegui

Or with uv:

uv add nicegui

Usage

Write your nice GUI in a file main.py:

from nicegui import ui

ui.label('Hello NiceGUI!')
ui.button('BUTTON', on_click=lambda: ui.notify('button was pressed'))

ui.run()

Launch it with:

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 and provides plenty of live demos. The whole content of https://nicegui.io is implemented with NiceGUI itself 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 of what you can do with NiceGUI. In our wiki we have a list of great NiceGUI projects from the community, a section with Tutorials and a growing list of FAQs. When building NiceGUI projects with AI assistants, point them at nicegui/llms.md — a concise reference that ships with the package (also served at https://nicegui.io/llms.txt).

Why?

We at Zauberzeug like Streamlit but find it does too much magic when it comes to state handling. In search for an alternative nice library to write simple graphical user interfaces in Python we discovered JustPy. Although we liked the approach, it is too "low-level HTML" for our daily usage. But it inspired us to use Vue and Quasar for the frontend.

We have built on top of FastAPI, which itself is based on the ASGI framework Starlette and the ASGI webserver Uvicorn because of their great performance and ease of use.

Sponsors

Maintenance of this project is made possible by all the contributors and sponsors. If you would like to support this project and have your avatar or company logo appear below, please sponsor us. 💖

Consider this low-barrier form of contribution yourself. Your support is much appreciated.

Contributing

We welcome contributions of all kinds and sizes. Please read CONTRIBUTING.md to get started.

Included Web Dependencies

See DEPENDENCIES.md for a list of web frameworks NiceGUI depends on.

Architecture

NiceGUI is a Python framework for building web UIs with a backend-first philosophy. Key architectural decisions:

• Backend-first: All UI logic lives in Python; the framework handles web details
• Tech stack: Python/FastAPI backend, Vue/Quasar frontend, socket.io for communication
• Single worker: Uses one uvicorn worker (thanks to full async support, no multi-process synchronization needed)
• Real-time communication: WebSocket connection is established after initial page load, kept open for client-server communication
• User interactions: All UI events are sent to backend and invoke Python functions, which can then generate UI updates
• Outbox: Accumulates UI updates and sends them in batches to the client