🖥️ Hello World KDE

Aplicativo Hello World para KDE Neon / Ubuntu
Feito com Python 3 + PyQt5 · Tema Catppuccin Mocha

---

✨ Sobre

Aplicativo simples que exibe Hello, World! em uma janela nativa do KDE.
Ideal para quem está começando a desenvolver aplicativos para Linux com Python e PyQt5.

---

📦 Instalação

✅ Opção 1 — Pacote .deb (recomendado)

Baixe o .deb na aba Releases, dê dois cliques e instale pelo Discover.

Ou pelo terminal:

sudo dpkg -i hello-world-kde_1.0.deb
sudo apt install -f

🐍 Opção 2 — Rodar pelo código fonte

git clone https://github.com/seu-usuario/hello-world-kde.git
cd hello-world-kde
sudo apt install python3-pyqt5
python3 src/hello_world.py

---

🏗️ Build do pacote .deb

chmod +x build.sh
./build.sh
# Gera: hello-world-kde_1.0.deb

---

📁 Estrutura do projeto

hello-world-kde/
├── src/
│   └── hello_world.py              # Código principal
├── assets/
│   └── hello-world-kde.svg         # Ícone do app
├── debian/
│   ├── control                     # Metadados do pacote
│   ├── hello-world-kde.desktop     # Atalho no menu KDE
│   └── postinst                    # Script pós-instalação
├── .github/
│   └── workflows/
│       └── build.yml               # GitHub Actions — gera .deb automático
├── build.sh                        # Script para gerar o .deb
├── LICENSE
└── README.md

---

🛠️ Requisitos

Requisito	Versão
Python	3.8+
PyQt5	5.x
Sistema	KDE Neon, Ubuntu 20.04+ ou qualquer distro com Qt5

---

🤝 Contribuindo

1. Faça um fork do projeto
2. Crie uma branch: git checkout -b minha-feature
3. Commit: git commit -m 'feat: minha feature'
4. Push: git push origin minha-feature
5. Abra um Pull Request

---

📄 Licença

MIT © seu-usuario