(This library is available under a free and permissive license)
Dear PyGui is a simple to use (but powerful) Python GUI framework. DearPyGui provides a wrapping of DearImGui that simulates a traditional retained mode GUI, as opposed to Dear ImGui's immediate mode paradigm.
Dear PyGui is fundamentally different than other Python GUI frameworks. Under the hood, DearPyGui uses the immediate mode paradigm allowing for extremely dynamic interfaces. DearPyGui does not use native widgets, but instead draws the widgets using your computer's GPU. DearPyGui is currently supported on the following platforms:
Platform | Rendering API |
---|---|
Windows 10 | DirectX 11 |
macOs | Metal |
Linux | OpenGL3 |
In the same manner Dear ImGui provides a simple way to create tools for game developers, DearPyGui provides a simple way for python developers to create quick and powerful GUIs for scripts.
Installing - Usage - Features - Building |
---|
Upcoming changes - Gallery - Credits - License |
Ensure you have the newest version of Python 3.8 (3.8.5 at the moment).
pip install dearpygui
or
pip3 install dearpygui
DearPyGui is an all included GUI framework. A variety of examples demonstrating usage can be found in the Examples folder /Examples. To get started checkout the Tutorials and for all other references visit the Documentation or from within the library by using the show_documentation command.
Using DearPyGui is a simple as creating a python script like the one below:
Code:
from dearpygui.dearpygui import *
add_text("Hello world")
add_button("Save", callback="save_callback")
add_input_text("string")
add_slider_float("float")
def save_callback(sender, data):
print("Save Clicked")
start_dearpygui()
DearPyGui includes a plotting API (ImPlot Wrapping)
DearPyGui currently includes 10 themes (a full custom theming system will be available in v0.2):
DearPyGui includes a drawing API to create custom drawings, plot, and even 2D games.
DearPyGui includes several tools to help developers with DearPyGui app development including built-in documentation, logging, source viewer, and other tools:
The actual builds of DearPyGui are created through github actions however, to develop and test locally, follow the instructions below:
- Visual Studio 2019 (windows) with the following workloads:
- Python development
- Desktop development with C++
- Game development with C++
- git
- From within a local directory, enter the following bash commands:
git clone --recursive https://github.com/RaylockLLC/DearPyGui
- Open the Scripts folder and run the BuildPythonForWindows.bat file.
- In Visual Studio, use Open a local folder to open DearPyGui folder.
- Switch to the release configuration and run Build All.
Only tested on Ubuntu 20.04
- cmake
- Python 3.8
- xorg-dev
- From within a local directory, enter the following bash commands:
git clone --recursive https://github.com/hoffstadt/DearPyGui
- Open the Scripts folder.
- Open the terminal and type the following commands:
chmod +x BuildForLinux.sh
sudo ./BuildForLinux.sh
Some upcoming features:
- An object oriented interface
- Additional Plot types (bar graph, pie chart, etc.)
- Support for window docking and multiple viewports.
- More complete theme and style system.
- 3D widget.
- Custom Widget API.
Developed by Jonathan Hoffstadt, Preston Cothren, and every direct or indirect contributor.
Omar Cornut for all his incredible work on Dear ImGui.
Evan Pezent for all his work on ImPlot
Aiekick for his work on the ImGuiFileDialog
DearPyGui is licensed under the MIT License.