nicegui

Schöne GUI

NiceGUI ist ein benutzerfreundliches, Python-basiertes UI-Framework, das in Ihrem Webbrowser angezeigt wird. Sie können Schaltflächen, Dialoge, Markdown, 3D-Szenen, Plots und vieles mehr erstellen.

Es eignet sich hervorragend für Micro-Web-Apps, Dashboards, Robotikprojekte, Smart-Home-Lösungen und ähnliche Anwendungsfälle. Sie können es auch in der Entwicklung verwenden, beispielsweise beim Optimieren/Konfigurieren eines Algorithmus für maschinelles Lernen oder beim Optimieren von Motorsteuerungen.

NiceGUI ist als PyPI-Paket, Docker-Image und auf Conda-Forge sowie GitHub verfügbar.

Merkmale

• browserbasierte grafische Benutzeroberfläche
• implizites Neuladen bei Codeänderung
• fungiert als Webserver (Zugriff über den Browser) oder im nativen Modus (z. B. Desktop-Fenster)
• Standard-GUI-Elemente wie Beschriftung, Schaltfläche, Kontrollkästchen, Schalter, Schieberegler, Eingabe, Datei-Upload, ...
• einfache Gruppierung mit Zeilen, Spalten, Karten und Dialogen
• Allzweck-HTML- und Markdown-Elemente
• leistungsstarke High-Level-Elemente zu
  • Plotgrafiken und Diagramme,
  • 3D-Szenen rendern,
  • Erhalten Sie Lenkereignisse über virtuelle Joysticks
  • Kommentieren und überlagern Sie Bilder
  • mit Tabellen interagieren
  • Navigieren Sie durch faltbare Baumstrukturen
  • Video- und Audiodateien einbetten
• Integrierter Timer zum Aktualisieren der Daten in Intervallen (sogar alle 10 ms)
• Einfache Datenbindung und aktualisierbare Funktionen, um noch weniger Code zu schreiben
• Benachrichtigungen, Dialoge und Menüs für eine hochmoderne Benutzerinteraktion
• geteilte und individuelle Webseiten
• Benutzerfreundliche Benutzerfreundlichkeit und allgemeine Persistenz
• Möglichkeit, benutzerdefinierte Routen und Datenantworten hinzuzufügen
• Erfassen Sie Tastatureingaben für globale Verknüpfungen usw.
• Passen Sie das Aussehen an, indem Sie Primär-, Sekundär- und Akzentfarben definieren
• Live-Zyklus-Ereignisse und Sitzungsdaten
• läuft in Jupyter Notebooks und ermöglicht den interaktiven Modus von Python
• Unterstützung für die automatische Vervollständigung von Tailwind CSS
• SVG-, Base64- und Emoji-Favicon-Unterstützung
• Testframework basierend auf Pytest

Installation

python3 -m pip install nicegui

Verwendung

Schreiben Sie Ihre schöne GUI in eine Datei main.py :

 from nicegui import ui

ui . label ( 'Hello NiceGUI!' )
ui . button ( 'BUTTON' , on_click = lambda : ui . notify ( 'button was pressed' ))

ui . run ()

Starten Sie es mit:

python3 main.py

Die GUI ist jetzt über http://localhost:8080/ in Ihrem Browser verfügbar. Hinweis: NiceGUI lädt die Seite automatisch neu, wenn Sie den Code ändern.

Dokumentation und Beispiele

Die Dokumentation wird unter https://nicegui.io/documentation gehostet und bietet zahlreiche Live-Demos. Der gesamte Inhalt von https://nicegui.io wird mit NiceGUI selbst implementiert und kann lokal mit docker run -p 8080:8080 zauberzeug/nicegui oder durch Ausführen von main.py aus diesem Repository gestartet werden.

Schauen Sie sich auch unsere ausführlichen Beispiele dafür an, was Sie mit NiceGUI tun können. In unserem Wiki haben wir eine Liste großartiger NiceGUI-Projekte aus der Community, einen Abschnitt mit Tutorials, eine wachsende Liste von FAQs und einige Strategien für die Verwendung von ChatGPT/LLMs, um Hilfe zu NiceGUI zu erhalten.

Warum?

Wir bei Zauberzeug mögen Streamlit, finden aber, dass es zu viel Magie hat, wenn es um die Zustandsverwaltung geht. Auf der Suche nach einer alternativen schönen Bibliothek zum Schreiben einfacher grafischer Benutzeroberflächen in Python haben wir JustPy entdeckt. Obwohl uns der Ansatz gefiel, ist er für unseren täglichen Gebrauch zu „Low-Level-HTML“. Aber es hat uns dazu inspiriert, Vue und Quasar für das Frontend zu verwenden.

Wir haben auf FastAPI aufgebaut, das aufgrund seiner hervorragenden Leistung und Benutzerfreundlichkeit auf dem ASGI-Framework Starlette und dem ASGI-Webserver Uvicorn basiert.

Sponsoren

Die Aufrechterhaltung dieses Projekts wird durch alle Mitwirkenden und Sponsoren ermöglicht. Wenn Sie dieses Projekt unterstützen möchten und Ihr Avatar oder Firmenlogo unten erscheinen soll, unterstützen Sie uns bitte. ?

Denken Sie selbst über diese barrierearme Beitragsform nach. Ihre Unterstützung wird sehr geschätzt.

Mitwirken

Vielen Dank für Ihr Interesse, einen Beitrag zu NiceGUI zu leisten! Wir freuen uns, Sie an Bord zu haben und schätzen Ihre Bemühungen, dieses Projekt noch besser zu machen.

Als wachsendes Open-Source-Projekt verstehen wir, dass es einer Gemeinschaftsanstrengung bedarf, um unsere Ziele zu erreichen. Deshalb freuen wir uns über alle Arten von Beiträgen, egal wie klein oder groß sie sind. Ob es darum geht, neue Funktionen hinzuzufügen, Fehler zu beheben, die Dokumentation zu verbessern oder neue Ideen vorzuschlagen, wir glauben, dass jeder Beitrag zählt und einen Mehrwert für unser Projekt darstellt.

Wir haben in unserer Datei CONTRIBUTING.md eine detaillierte Anleitung zum Mitwirken an NiceGUI bereitgestellt. Wir empfehlen Ihnen, es sorgfältig zu lesen, bevor Sie Beiträge leisten, um sicherzustellen, dass Ihre Arbeit mit den Zielen und Standards des Projekts übereinstimmt.

Wenn Sie Fragen haben oder Hilfe benötigen, zögern Sie bitte nicht, uns zu kontaktieren. Wir sind immer für Sie da, um Sie durch den Beitragsprozess zu unterstützen und zu begleiten.

Enthaltene Webabhängigkeiten

Unter DEPENDENCIES.md finden Sie eine Liste der Web-Frameworks, von denen NiceGUI abhängt.