_{(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

Installing

---

Ensure you have the newest version of Python 3.8 (3.8.5 at the moment).

pip install dearpygui
or
pip3 install dearpygui

Usage

---

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()

Result:

Some Features

---

Plotting/Graphing

DearPyGui includes a plotting API (ImPlot Wrapping)

Themes

DearPyGui currently includes 10 themes (a full custom theming system will be available in v0.2):

Canvas

DearPyGui includes a drawing API to create custom drawings, plot, and even 2D games.

Tools

DearPyGui includes several tools to help developers with DearPyGui app development including built-in documentation, logging, source viewer, and other tools:

Building

The actual builds of DearPyGui are created through github actions however, to develop and test locally, follow the instructions below:

---

Windows 10

Build Requirements

• Visual Studio 2019 (windows) with the following workloads:
  • Python development
  • Desktop development with C++
  • Game development with C++
• git

Instructions

1. From within a local directory, enter the following bash commands:

git clone --recursive https://github.com/RaylockLLC/DearPyGui

2. Open the Scripts folder and run the BuildPythonForWindows.bat file.
3. In Visual Studio, use Open a local folder to open DearPyGui folder.
4. Switch to the release configuration and run Build All.

Linux

_{Only tested on Ubuntu 20.04}

Build Requirements

• cmake
• Python 3.8
• xorg-dev

Instructions

1. From within a local directory, enter the following bash commands:

git clone --recursive https://github.com/hoffstadt/DearPyGui

2. Open the Scripts folder.
3. Open the terminal and type the following commands:

chmod +x BuildForLinux.sh
sudo ./BuildForLinux.sh

Upcoming Changes

---

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.

Credits

---

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

Gallery

---

License

---

DearPyGui is licensed under the MIT License.