The PyDevices ecosystem
omnipython is one repository in a larger organization. This page is the map
of the repositories; the stack lists the modules and tools inside
them.
The repositories
Tier 1: Core Platform & Board Contract
Standard hardware driver engine and companion reference code.
omnipython— Unified pure-Python hardware abstraction layer and core device contract for MicroPython, CircuitPython, CPython, direct WebAssembly, Pyodide, and Android.audiodsp— CircuitPython’s audio system (audiocore, synthio, audiomixer, effects, audiomp3) ported to MicroPython and CPython, extending CircuitPython along the way: dynamics, routing, convolution, and offline rendering. On PyPI as omnipython-audiodsp; the instrument and effect libraries built on it are audioinstruments and audioeffects.audioinstruments— Playable synthesizers, organs, electric pianos and drum machines, each a patch of modules on a virtual rack, rendered a block at a time on audiodsp. Pure Python on CPython and MicroPython-compatible firmware. Install omnipython-audioinstruments from PyPI, or audioinstruments from the MIP index.audioeffects— Compressors, EQs, reverbs, delays, modulation, drive and amp simulation, pitch shifters and racks, pure Python on audiodsp’s audio nodes, the same on MicroPython-compatible boards, CircuitPython-compatible boards and a desktop. Install omnipython-audioeffects from PyPI, or audioeffects from the MIP index.gallery— Comprehensive example code, direct MicroPython WebAssembly demos, board configurations, and multi-interpreter showcase benchmarks.
Tier 2: Python Framebuffers & GUI Toolkits
Pure Python on any Python 3 host; pygraphics adds native wheels for Linux x86_64, Windows, Android and Pyodide.
pygraphics— Native C and pure-Python 2D graphics library with drawing primitives, bitmap font rendering, paletted surface blitting, and area-dirtying pipelines.palettes— Color management library with RGB565 / RGB888 output, an HSV color wheel, RGB color cubes, Material Design swatches, and Win16 color names.iconkit— Material Design icons as flash-resident alpha masks, drawn in LVGL or pygraphics.pdwidgets— A complete UI widget framework in Python with no C: buttons, sliders, progress bars, labels and event routing on OmniPython screens. It demonstrates that the core can carry a UI framework; for an interface you ship, use LVGL. Not in release firmware:mip install pdwidgets.
Tier 3: LVGL Native Extensions & Binding Generator
Single-source LVGL C header binding generator and native interpreter modules.
omnipython-lvgl— LVGL v9 for Python: one binding generator turns LVGL’s C headers into a MicroPython module, a CircuitPython module and a CPython wheel, so a program imports lvgl the same way on a desktop and on both kinds of board.
Tier 4: App Hosts & Mobile
Deploy PyDevices apps directly to desktop browsers or mobile APKs.
pyscript-template— Progressive Web App starter template repository for deploying offline-capable client-side OmniPython applications on GitHub Pages.android-template— Pre-configured python-for-android build recipes and Buildozer project template for packaging OmniPython applications into native Android APKs.
Tier 5: Developer Tools & Infrastructure
MIP package indexing, multi-usermod builds, and serial/FTP IDE extensions.
mcuctl— Connect MicroPython and CircuitPython boards from VS Code, Cursor, or the CLI, over USB or Wi-Fi: dual-pane file transfer, in-editor REPL, firmware builds and flashing, mip/circup, plus RPC and an optional browser PWA.omnipython-builds— The OmniPython patch queue for MicroPython, kept like a distribution keeps one: an ordered, provenance-tracked patch series over the pinned upstream (MicroPython v1.30.0-preview-160), with presets, boards and variants that build PyDevices modules into firmware with upstream’s own make.workbench— A ViperIDE fork with a built-in WebAssembly MicroPython simulator: edit, run, and debug OmniPython code against a simulated board entirely in the browser, no hardware required.mpvst— Programmable VST3 instruments and effects: every audioinstruments instrument and audioeffects effect as a named plug-in, each instance running its Python in a sidecar process. Installers for Windows and Linux; nothing has to be built.
Moved into other repositories:
displayif — now
modules/displayifin omnipython-builds. The old repository is archived.audiocomponents — split into
audioinstrumentsandaudioeffects. The old repository is archived.audioif — now
modules/audioifin omnipython-builds. The old repository is archived.cameraif — now
modules/cameraifin omnipython-builds. The old repository is archived.usbif — the C module is now
modules/usbhostin omnipython-builds; the Python USB packages are in omnipython. The old repository is archived.lvgl-bindings — now
bindingin omnipython-lvgl. The old repository is archived.lvgl-micropython — now
ports/micropythonin omnipython-lvgl. The old repository is archived.lvgl-python — now
ports/cpythonin omnipython-lvgl. The old repository is archived.lvgl-circuitpython — now
ports/circuitpythonin omnipython-lvgl. The old repository is archived.
Deliberately absent from this map:
android-runner — Exists solely to enable omnipython/bin/android.py. The APK is documented in omnipython; the runner publishes no site.