# 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
```bash
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
```bash
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`

```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:
```bash
source venv/bin/activate
```

2. Edite `buddie_chat.py`

3. Execute:
```bash
python3 buddie_chat.py
```

## Funcionalidades Implementadas

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

---

**Descomplicar® Crescimento Digital** | versão 1.0