Buddie Chat - Aplicação Nativa Linux

Interface nativa para servidores MCP (Model Context Protocol)

Descomplicar® Crescimento Digital
https://descomplicar.pt

Características

• ✅ Aplicação nativa Linux com GTK4 + Libadwaita
• ✅ Interface moderna seguindo design patterns do GNOME
• ✅ Configuração de múltiplos MCPs com teste de conexão
• ✅ Suporte OpenAI e OpenRouter para processamento de mensagens
• ✅ Gestão de configuração persistente
• ✅ Chat em tempo real com interface intuitiva

Requisitos do Sistema

• Linux (testado no Linux Mint)
• Python 3.8+
• GTK 4.0
• Libadwaita 1.0

Instalação

1. Dependências do sistema

sudo apt update
sudo apt install python3 python3-pip python3-venv
sudo apt install python3-gi python3-gi-cairo gir1.2-gtk-4.0 gir1.2-adw-1

2. Instalar aplicação

cd /media/ealmeida/Dados/Dev/buddie-chat
./run.sh

O script automaticamente:

• Cria ambiente virtual Python
• Instala dependências necessárias
• Executa a aplicação

Como Usar

1. Configurar APIs

• Abra a aplicação
• Na barra lateral, configure sua chave OpenAI ou OpenRouter
• As configurações são guardadas automaticamente

2. Adicionar Servidores MCP

• Clique em "Adicionar MCP"
• Configure:
  • Nome: Nome amigável para o servidor
  • Comando: Caminho para executável MCP
  • Argumentos: Parâmetros do servidor (opcional)

3. Conversar

• Selecione um servidor MCP da lista
• Digite sua mensagem no campo inferior
• Pressione Enter ou clique em "Enviar"

Estrutura do Projeto

buddie-chat/
├── buddie_chat.py      # Aplicação principal
├── requirements.txt    # Dependências Python
├── run.sh             # Script de execução
├── style.css          # Estilos GTK
└── README.md          # Este ficheiro

Configuração

As configurações são guardadas em: ~/.buddie-chat/config.json

{
  "openai_key": "sk-...",
  "openrouter_key": "sk-...",
  "theme": "dark",
  "mcps": [
    {
      "id": "mcp_0",
      "name": "Exemplo MCP",
      "command": "/path/to/mcp-server",
      "args": ["--port", "8080"],
      "enabled": true
    }
  ]
}

Vantagens da Aplicação Nativa

• Performance superior - Sem overhead do browser
• Integração com o sistema - Notificações nativas, gestão de janelas
• Menor consumo de recursos - Mais eficiente que Electron
• Interface consistente - Segue design do ambiente desktop
• Estabilidade - Menos dependências, mais confiável

Desenvolvimento

Para modificar a aplicação:

1. Ative o ambiente virtual:

source venv/bin/activate

2. Edite buddie_chat.py

3. Execute:

python3 buddie_chat.py

Funcionalidades Implementadas

• Interface GTK4 com Libadwaita
• Configuração de chaves API (OpenAI/OpenRouter)
• Gestão de múltiplos servidores MCP
• Teste de conexão MCP
• Chat funcional com processamento assíncrono
• Persistência de configuração
• Interface responsiva e moderna

---

Descomplicar® Crescimento Digital | versão 1.0