{"id":23631,"library":"dpgui","title":"DPGui","description":"A web-based GUI for user inputs, built on top of Dear PyGui. Version 1.0.1, maintenance mode with infrequent releases.","status":"active","version":"1.0.1","language":"python","source_language":"en","source_url":"https://github.com/hoffstadt/dpgui","tags":["gui","web","dearpygui","user-input"],"install":[{"cmd":"pip install dpgui","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"Core dependency for the GUI backend.","package":"dearpygui","optional":false}],"imports":[{"note":"Using wildcard imports is discouraged; use the module alias 'dp' for clarity.","wrong":"from dpgui import *","symbol":"dp","correct":"import dpgui as dp"},{"note":"start is a function in the dpgui module, not a submodule.","wrong":"from dpgui.start import start","symbol":"start","correct":"import dpgui as dp; dp.start()"}],"quickstart":{"code":"import dpgui as dp\n\ndef callback(values):\n    print('User input:', values)\n\ndp.start(callback=callback, title='My App', fields=[{'name': 'name', 'type': 'text', 'label': 'Your Name'}])\n","lang":"python","description":"Creates a simple web GUI with a text input field and displays the submitted value."},"warnings":[{"fix":"Set the port via `os.environ['DPGUI_PORT'] = '8080'` before calling `start()`.","message":"dpgui 1.0.0 changed the API: the `start` function no longer accepts a `port` argument; use environment variable `DPGUI_PORT` or modify source.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Use 'name' as the key for field identifiers.","message":"The `fields` parameter in `start()` expects 'name', 'type', 'label' keys; using 'id' instead of 'name' is deprecated and will be removed in 2.0.","severity":"deprecated","affected_versions":"<=1.0.1"},{"fix":"Install dearpygui via `pip install dearpygui`.","message":"dpgui requires Dear PyGui to be installed. If you install dpgui without dearpygui, it will fail at runtime.","severity":"gotcha","affected_versions":"all"},{"fix":"Set `os.environ['DPGUI_HOST'] = '0.0.0.0'` before running `start()`.","message":"The web GUI runs on localhost only by default. To expose it to other machines, you must set `DPGUI_HOST` environment variable to '0.0.0.0'.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run `pip install dearpygui`.","cause":"dpgui depends on dearpygui but does not install it automatically.","error":"ModuleNotFoundError: No module named 'dearpygui'"},{"fix":"Use `os.environ['DPGUI_PORT'] = '8080'` before calling `dp.start()`.","cause":"The 'port' argument was removed in v1.0.0; set via environment variable instead.","error":"TypeError: start() got an unexpected keyword argument 'port'"},{"fix":"Change 'id' to 'name' in the field dictionary.","cause":"The field definition key 'id' was renamed to 'name' in v1.0.0.","error":"ValueError: Unknown field key: 'id'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}