Repolode
alfiopuglisi

alfiopuglisi/guietta

Uma biblioteca Python para criar GUIs desktop simples com poucas linhas de código, baseada em Qt.

Estrelas
1,953
Forks
93
Issues abertas
13
Último commit
há 12 dias

O que é?

Guietta permite que desenvolvedores Python criem interfaces gráficas desktop descrevendo o layout como listas aninhadas de widgets. Cada célula da lista vira um widget, como um rótulo, campo de texto ou botão, e marcadores indicam posições vazias na grade. Os manipuladores de eventos são associados com um bloco simples `with gui.ButtonName:`, permitindo escrever uma pequena calculadora em poucas linhas.

A biblioteca atende a necessidades comuns além de formulários básicos. Ela integra matplotlib e pyqtgraph para criar gráficos acionados por eventos, pode exibir colunas de dados em rótulos a partir de listas e dicts e oferece suporte a várias janelas. É possível personalizar o tratamento de exceções nos manipuladores, e há suporte a processamento em segundo plano para operações demoradas. Qualquer widget Qt derivado de QWidget, inclusive widgets personalizados, pode ser incluído no layout, e os sinais e slots padrão do Qt continuam disponíveis.

Por padrão, Guietta usa PySide2 e pode recorrer ao PyQt5 quando PySide2 não está disponível. A instalação é feita com pip, e o projeto oferece documentação sobre hospedagem e compatibilidade com conda.

Recursos principais

  • 01Descreve layouts de GUI como listas aninhadas de widgets, com marcadores para células vazias.
  • 02Associa manipuladores de eventos com um bloco simples `with gui.ButtonName:`.
  • 03Integra matplotlib e pyqtgraph para criar gráficos acionados por eventos.
  • 04Oferece suporte a várias janelas e ao tratamento personalizável de exceções.
  • 05Aceita qualquer widget Qt derivado de QWidget, inclusive widgets personalizados.

Casos de uso

  • Criar rapidamente um utilitário pequeno, como uma calculadora ou um formulário de entrada de dados.
  • Adicionar uma janela simples com gráfico interativo a um script de análise de dados.
  • Prototipar uma interface desktop sem precisar aprender toda a API do Qt.

Início rápido

  1. 1

    Instale o guietta com pip

    pip install guietta
  2. 2

    Crie um arquivo Python com o código de exemplo da GUI e execute-o com gui.run()

Antes de usar

  • Por padrão, usa o binding Qt PySide2, que não está disponível em alguns sistemas, como Macs mais antigos e Raspberry Pi. Por isso, talvez seja necessário instalar o PyQt5 manualmente.

Em coleções

Tópicos

#gui#qt#pyside2#pyqt5#desktop-app#python-gui#matplotlib

Perguntas frequentes

O que é guietta?
Uma biblioteca Python para criar GUIs desktop simples com poucas linhas de código, baseada em Qt. Guietta permite que desenvolvedores Python criem interfaces gráficas desktop descrevendo o layout como listas aninhadas de widgets. Cada célula da lista vira um widget, como um rótulo, campo de texto ou botão, e marcadores indicam posições vazias na grade. Os manipuladores de eventos são associados com um bloco simples `with gui.ButtonName:`, permitindo escrever uma pequena calculadora em poucas linhas.
guietta é gratuito? Qual é a licença?
guietta é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
guietta ainda é mantido?
Manutenção ativa. O último commit de guietta foi em 27 de out. de 2026.
Para que posso usar guietta?
Criar rapidamente um utilitário pequeno, como uma calculadora ou um formulário de entrada de dados. Adicionar uma janela simples com gráfico interativo a um script de análise de dados. Prototipar uma interface desktop sem precisar aprender toda a API do Qt.
Como instalar guietta?
Instale o guietta com pip: pip install guietta Crie um arquivo Python com o código de exemplo da GUI e execute-o com gui.run()
Onde consigo guietta?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/alfiopuglisi/guietta

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados

Uma biblioteca Python que simplifica a criação de janelas GUI com tkinter, Qt, wxPython e Remi por meio de uma API compacta e acessível para iniciantes.

13,8 mil1,8 milPythonLGPL-3.0Bem mantidoAtualizado há 5 dias

Biblioteca Python para criar janelas PyQt/PySide sem bordas, com barras de título personalizadas, redimensionamento e efeitos nativos de desfoque no Windows, Linux e macOS.

Frontend e UI#pyqt#pyside#qt
768+2 esta semana98PythonGPL-3.0Atualizado há 3 meses