Metadata-Version: 2.2
Name: imgui-bundle
Version: 1.92.600
Summary: Dear ImGui Bundle: From expressive code to powerful GUIs in no time. A fast, feature-rich, cross-platform toolkit for C++ and Python.
Author-Email: Pascal Thomet <pthomet@gmail.com>
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Scientific/Engineering
Classifier: Typing :: Typed
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Project-URL: Homepage, https://pthom.github.io/imgui_bundle/
Project-URL: Documentation, https://pthom.github.io/imgui_bundle/
Project-URL: Repository, https://github.com/pthom/imgui_bundle
Project-URL: Issues, https://github.com/pthom/imgui_bundle/issues
Project-URL: Changelog, https://github.com/pthom/imgui_bundle/blob/main/CHANGELOG.md
Requires-Python: >=3.10
Requires-Dist: numpy
Provides-Extra: matplotlib
Requires-Dist: matplotlib; extra == "matplotlib"
Provides-Extra: imgproc
Requires-Dist: pillow; extra == "imgproc"
Requires-Dist: opencv-python; extra == "imgproc"
Provides-Extra: pydantic
Requires-Dist: pydantic>=2.0.0; extra == "pydantic"
Provides-Extra: opengl
Requires-Dist: PyOpenGL; extra == "opengl"
Provides-Extra: glfw
Requires-Dist: glfw; extra == "glfw"
Provides-Extra: sdl2
Requires-Dist: PySDL2; extra == "sdl2"
Provides-Extra: sdl3
Requires-Dist: PySDL3; extra == "sdl3"
Provides-Extra: wgpu
Requires-Dist: wgpu; extra == "wgpu"
Requires-Dist: rendercanvas; extra == "wgpu"
Provides-Extra: pyglet
Requires-Dist: pyglet; extra == "pyglet"
Provides-Extra: all-backends
Requires-Dist: PyOpenGL; extra == "all-backends"
Requires-Dist: glfw; extra == "all-backends"
Requires-Dist: PySDL2; extra == "all-backends"
Requires-Dist: PySDL3; extra == "all-backends"
Requires-Dist: wgpu; extra == "all-backends"
Requires-Dist: pyglet; extra == "all-backends"
Provides-Extra: full
Requires-Dist: matplotlib; extra == "full"
Requires-Dist: pillow; extra == "full"
Requires-Dist: opencv-python; extra == "full"
Requires-Dist: PyOpenGL; extra == "full"
Requires-Dist: glfw; extra == "full"
Requires-Dist: PySDL2; extra == "full"
Requires-Dist: PySDL3; extra == "full"
Requires-Dist: wgpu; extra == "full"
Requires-Dist: rendercanvas; extra == "full"
Requires-Dist: pyglet; extra == "full"
Requires-Dist: pydantic>=2.0.0; extra == "full"
Requires-Dist: PyGLM; extra == "full"
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-asyncio; extra == "test"
Description-Content-Type: text/markdown

<a href="https://traineq.org/imgui_bundle_explorer">
<img src="https://raw.githubusercontent.com/pthom/imgui_bundle/refs/heads/main/bindings/imgui_bundle/demos_assets/images/badge_interactive_explorer.png" alt="interactive manual" height="25"/>
</a>
&nbsp;
<a href="https://pthom.github.io/imgui_bundle/">
<img src="https://raw.githubusercontent.com/pthom/imgui_bundle/refs/heads/main/bindings/imgui_bundle/demos_assets/images/badge_view_docs.png" alt="view docs" height="25"/>
</a>

# Dear ImGui Bundle

> “Dear ImGui Bundle: easily create applications in Python and C++. Batteries included! With very few lines of code, you can build a responsive GUI, and deploy it to desktop or directly in the browser.”

Dear ImGui Bundle is a collection of libraries around [Dear ImGui](https://github.com/ocornut/imgui), for both C++ and Python. It focuses on rapid prototyping, tooling, and educational demos, with first‑class support for desktop and web.

## Key features

- Cross‑platform: Windows, macOS, Linux, iOS, Android, and WebAssembly.
- C++ and Python APIs with very similar structure.
- Integrated ecosystem:
  - Dear ImGui (core widgets)
  - ImPlot / ImPlot3D (2D and 3D plotting)
  - ImmVision (image inspection)
  - imgui-node-editor, ImGuizmo, file dialogs, knobs, spinners, toggles, command palette, and more.
- Optional high‑level runners:
  - Hello ImGui: window, backend, docking, and assets management.
  - ImmApp: easy activation of add‑ons (ImPlot, Markdown, etc.).
- Web‑ready:
  - C++ via Emscripten
  - Python via Pyodide (online playground and deployable HTML templates)

> “Think of it as a toolbox where all the pieces are pre‑wired to play well together: plotting, Markdown, node editors, image inspection, and more, ready to drop into your app.”

***

## Documentation and interactive explorer

### Documentation site

Click the image below to visit the documentation site:

<a href="https://pthom.github.io/imgui_bundle/">
<img src="https://raw.githubusercontent.com/pthom/imgui_bundle/refs/heads/main/bindings/imgui_bundle/demos_assets/images/badge_view_docs.png" alt="view docs" height="25"/>
</a>

This site contains the full documentation for Dear ImGui Bundle, including install instructions, conceptual introductions, step‑by‑step tutorials, deployment recipes, etc. It is a companion to "Dear ImGui Bundle Explorer", an Explorer below.

### Interactive manual & demo

Click the image below to launch the interactive manual in your web browser:

<a href="https://traineq.org/imgui_bundle_explorer">
<img src="https://raw.githubusercontent.com/pthom/imgui_bundle/refs/heads/main/bindings/imgui_bundle/demos_assets/images/badge_interactive_explorer.png" alt="interactive manual" height="25"/>
</a>

The interactive manual showcases almost every part of the bundle with runnable examples. You can:
- Explore core Dear ImGui widgets.
- Try plotting, node editors, image viewers, test engine, and more.
- Inspect and copy the C++ and Python source code for each demo.

> “The interactive manual is intended to be your live reference: browse widgets, run demos, and copy code snippets directly into your own projects.”


### Online playground (Pyodide):
Run and edit Python ImGui Bundle apps directly in your browser:
- No installation.
- Type code on the left, see the interactive GUI on the right.
- Great for experimentation, teaching, and sharing small examples.

Open the [playground](https://traineq.org/imgui_bundle_online/projects/imgui_bundle_playground/).
