Skip to main content

Web User Interface with Buttons, Dialogs, Markdown, 3D Scences and Plots

Project description


NiceGUI is an easy-to-use, Python-based UI framework, which renders to the 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 GitHub.

PyPI version PyPI - Downloads Docker Pulls
GitHub commit activity GitHub issues GitHub forks GitHub stars GitHub license


  • browser-based graphical user interface
  • shared state between multiple browser windows
  • implicit reload on code change
  • 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 images
  • built-in timer to refresh data in intervals (even every 10 ms)
  • straight-forward data binding to write even less code
  • notifications, dialogs and menus to provide state of the art user interaction
  • ability to add custom routes and data responses
  • capture keyboard input for global shortcuts etc
  • customize look by defining primary, secondary and accent colors


python3 -m pip install nicegui


Write your nice GUI in a file

from nicegui import ui

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

Launch it with:


The GUI is now available through http://localhost:8080/ in your browser. Note: The script will automatically reload the page when you modify the code.

Full documentation can be found at


You can call with optional arguments:

  • host (default: '')
  • port (default: 8080)
  • title (default: 'NiceGUI')
  • favicon (default: 'favicon.ico')
  • dark: whether to use Quasar's dark mode (default: False, use None for "auto" mode)
  • reload: automatically reload the ui on file changes (default: True)
  • show: automatically open the ui in a browser tab (default: True)
  • uvicorn_logging_level: logging level for uvicorn server (default: 'warning')
  • uvicorn_reload_dirs: string with comma-separated list for directories to be monitored (default is current working directory only)
  • uvicorn_reload_includes: string with comma-separated list of glob-patterns which trigger reload on modification (default: '.py')
  • uvicorn_reload_excludes: string with comma-separated list of glob-patterns which should be ignored for reload (default: '.*, .py[cod], .sw.*, ~*')
  • main_page_classes: configure Quasar classes of main page (default: 'q-ma-md column items-start')
  • binding_refresh_interval: time between binding updates (default: 0.1 seconds, bigger is more cpu friendly)
  • exclude: comma-separated string to exclude libraries (with corresponding elements) to save bandwidth and/or startup time:
    • "aggrid" (ui.table)
    • "colors" (ui.colors)
    • "custom_example" (ui.custom_example)
    • "highcharts" (ui.chart)
    • "interactive_image" (ui.interactive_image)
    • "keyboard" (ui.keyboard)
    • "log" (ui.log)
    • "matplotlib" (ui.plot and ui.line_plot)
    • "nipple" (ui.joystick)
    • "three" (ui.scene)
  • interactive: used internally when run in interactive Python shell (default: False)

The environment variables HOST and PORT can also be used to configure NiceGUI.


You can use our multi-arch Docker image for pain-free installation:

docker run --rm -p 8888:8080 -v $(pwd):/app/ -it zauberzeug/nicegui:latest

This will start the server at http://localhost:8888 with the code from your current directory. The file containing your, ...) command must be named Code modification triggers an automatic reload.


We 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. While too "low-level HTML" for our daily usage it provides a great basis for "NiceGUI".


The API reference is hosted at and is implemented with NiceGUI itself. You may also have a look at for more demonstrations of what you can do with NiceGUI.


NiceGUI is based on JustPy which is based on the ASGI framework Starlette and the ASGI webserver Uvicorn.


To deploy your NiceGUI app, you will need to execute your (or whichever file contains your on your server infrastructure. You can either install the NiceGUI python package via pip on the server or use our pre-built Docker image which contains all necessary dependencies. For example you can use this docker run command to start the script in the current directory on port 80:

docker run -p 80:8080 -v $(pwd)/:/app/ -d --restart always zauberzeug/nicegui:latest

The example assumes uses the port 8080 in the command (which is the default). The --restart always makes sure the container is restarted if the app crashes or the server reboots. Of course this can also be written in a docker compose file:

  image: zauberzeug/nicegui:latest
  restart: always
    - 80:8080
    - ./:/app/

While it is possible to provide SSL certificates directly through NiceGUI (using JustPy config) we suggest to use a reverse proxy like Traefik or NGINX.

Project details

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nicegui-0.8.7.tar.gz (4.6 MB view hashes)

Uploaded source

Built Distribution

nicegui-0.8.7-py3-none-any.whl (4.7 MB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page