{"repo": "bernardomachadosousa/sume", "files": {"README.md": {"af2dd6f5d2f338278327ba0bed00967dd964891a": {"t": 1785747251.6727526, "n": 5765, "h": "70f472c6de2454f1", "c": "# ⚡ Sumé — Assistente Virtual\n\nAssistente pessoal com voz, memória e automações.\n\n---\n\n## 1. O que instalar\n\n| Ferramenta | Link                              | Observação                             |\n| ---------- | --------------------------------- | -------------------------------------- |\n| Python     | https://python.org                | **Marcar \"Add to PATH\"** na instalação |\n| Git        | https://git-scm.com/downloads/win | Instalação padrão (Next, Next, Finish) |\n| VS Code    | https://code.visualstudio.com     | Editor de código                       |\n\n### Conferir se instalou certo\n\nAbra o **CMD** (Windows + R, digite `cmd`, Enter) e execute:\n\n```bash\npython --version\n```\n\nDeve mostrar `Python 3.10.x` ou superior.\n\n```bash\ngit --version\n```\n\nDeve mostrar `git version 2.x.x`.\n\n```bash\ncode --version\n```\n\nDeve mostrar a versão do VS Code.\n\n---\n\n## 2. Baixar o projeto\n\n```bash\ngit clone https://github.com/BernardoMachadoSousa/sume.git\ncd sume\n```\n\n---\n\n## 3. Criar ambiente virtual e instalar dependências\n\n```bash\npython -m venv venv\nvenv\\Scripts\\activate\npip install -r requirements.txt\n```\n\n---\n\n## 4. Baixar modelo de voz (Vosk)\n\n* Link direto: https://alphacephei.com/vosk/models/vosk-model-small-pt-0.3.zip\n* Site com todos os modelos: https://alphacephei.com/vosk/models\n\nPassos:\n\n1. Extraia o `.zip` para dentro da pasta `sume`\n2. Renomeie a pasta extraída para `modelo_voz`\n\nDeve ficar assim: `C:\\Users\\seu-usuario\\sume\\modelo_voz\\`\n\n---\n\n## 5. Criar arquivo de configuração\n\n```bash\nmkdir dados\necho {\"gemini_api_key\": \"\"} > dados\\configuracoes.json\n```\n\n---\n\n## 6. Rodar o projeto\n\n```bash\npython main.py\n```\n\nSe tudo deu certo, a janela do Sumé vai abrir.\n\n---\n\n## 📁 Estrutura de pastas\n\n```\nsume/\n├── main.py                 # Inicia o app\n├── requirements.txt        # Bibliotecas necessárias\n├── core/\n│   └── nexus_core.py       # Interpreta comandos\n├── modulos/\n│   ├── memoria.py          # Memória\n│   ├── automacoes.py       # Abrir/fechar apps e sites\n│   └── ia_conversacional.py # IA\n├── utils/\n│   ├── voz.py              # Fala\n│   └── escuta.py           # Escuta\n├── interface/\n│   ├── index.html          # Tela\n│   └── assets/\n│       ├── style.css       # Visual\n│       └── script.js       # Comportamento\n└── dados/\n    └── configuracoes.json  # Chaves\n```\n\n---\n\n## 🔄 Como usar o Git\n\n### Configurar (só na primeira vez)\n\n```bash\ngit config --global user.email \"seu-email@gmail.com\"\ngit config --global user.name \"SeuNomeNoGitHub\"\n```\n\n### Antes de programar\n\n```bash\ngit pull\n```\n\n### Depois de fazer alterações\n\n```bash\ngit add .\ngit commit -m \"O que você fez\"\ngit push\n```\n\n---\n\n## 🤝 Regras da equipe\n\n1. **Sempre faça **``** antes de começar**\n2. Avise no WhatsApp o que vai mexer\n3. Teste antes de dar `git push`\n4. Não mexa no `main.py` ou `dados/configuracoes.json` sem avisar\n5. Commits em português, objetivos: `\"Adicionei comando de clima\"`\n\n---\n\n## ❗ Problemas comuns\n\n| Erro                        | Solução                                   |\n| --------------------------- | ----------------------------------------- |\n| `pip não é reconhecido`     | Reinstale o Python marcando \"Add to PATH\" |\n| PowerShell não ativa venv   | Use o **CMD**, não o PowerShell           |\n| `ModuleNotFoundError`       | `pip install nome-do-modulo`              |\n| `modelo_voz não encontrado` | O modelo Vosk não está na pasta correta   |\n\n---\n\n## 📖 Histórico do projeto\n\nConversa completa com todas as decisões e ideias:\n\nhttps://chat.deepseek.com/share/6f64u0d6s37xcameki\n\n---\n\n## 👥 Time\n\n* Bernardo Machado Sousa — Coordenação\n* Gabriel Almeida Carvalho\n* Matheus Torquato Gomes\n\n---\n\nSalve (Ctrl+S) e depois no CMD:\n\n```bash\ngit add README.md\ngit commit -m \"README final organizado\"\ngit push\n```\n\n\n## 📋 Tarefas do Sumé\n\n### ✅ Concluído\n- [x] Edge TTS (voz natural Antônio)\n- [x] Ollama + Phi-3 Mini (IA local)\n- [x] Whisper (reconhecimento de voz)\n- [x] VAD (detecção de silêncio)\n- [x] Push-to-talk (segurar Espaço)\n- [x] SQLite (substituiu JSON)\n- [x] Automações inteligentes (abrir/fechar programas)\n- [x] Pré-carregamento do Whisper\n- [x] Atalhos de desenvolvimento\n\n---\n\n## 📋 Tarefas do Sumé\n\n### ✅ Concluído\n- [x] Edge TTS (voz natural Antônio)\n- [x] Ollama + Phi-3 Mini (IA local)\n- [x] Whisper (reconhecimento de voz)\n- [x] VAD (detecção de silêncio)\n- [x] Push-to-talk (segurar Espaço)\n- [x] SQLite (substituiu JSON)\n- [x] Automações inteligentes (abrir/fechar programas)\n- [x] Pré-carregamento do Whisper\n- [x] Atalhos de desenvolvimento\n- [x] Corrigir inconsistência `nome` vs `nome_usuario`\n- [x] Sistema de logs\n- [x] Remover `except: pass`\n- [x] Catálogo/cache de programas\n- [x] Centralizar interpretação no Core\n- [x] Tratamento padronizado de resultados (classe Resultado)\n- [x] Testes automatizados (20 testes)\n\n### 🔴 Fase 1 — Estabilidade e Organização 🎉\n- [x] Tudo concluído!\n\n### 🟡 Fase 2 — Preparação para Crescimento 🎉\n- [x] Sistema de intenções (core/intents/)\n- [x] Configurações persistentes (dados/config.json)\n- [x] Modo desenvolvedor\n- [ ] DeepSeek API (aguardando crédito)\n\n### 🟢 Fase 3 — Experiência do Usuário\n- [ ] Correção inteligente de voz\n- [ ] Histórico visual de conversas\n- [ ] Atalho global Ctrl+Espaço\n- [ ] Feedback sonoro\n\n### 🔵 Fase 4 — Utilidade Real\n- [ ] Memória contextual\n- [ ] Agendamentos e lembretes\n- [ ] Busca inteligente no computador\n- [ ] Comandos compostos\n- [ ] Central de conhecimento pessoal\n\n### 🟣 Fase 5 — Escalabilidade\n- [ ] Sistema de plugins\n- [ ] Perfis de usuário\n- [ ] Dashboard administrativo\n- [ ] Camada de serviços\n- [ ] Expandir cobertura de testes\n\n### ⚫ Fase 6 — Avançado\n- [ ] Palavra de ativação \"Sumé\"\n- [ ] OCR e leitura de tela\n- [ ] Automação de navegador\n- [ ] Modo reunião\n- [ ] Resumo automático do dia\n- [ ] Multiagentes"}, "1b605f3d292728a1aafca77252acb7d019b75c66": {"t": 1785771795.576189, "n": 5859, "h": "f13c7ae7c1075204", "c": "# ⚡ Sumé — Assistente Virtual\n\nAssistente pessoal com voz, memória e automações.\n\n---\n\n## 1. O que instalar\n\n| Ferramenta | Link                              | Observação                             |\n| ---------- | --------------------------------- | -------------------------------------- |\n| Python     | https://python.org                | **Marcar \"Add to PATH\"** na instalação |\n| Git        | https://git-scm.com/downloads/win | Instalação padrão (Next, Next, Finish) |\n| VS Code    | https://code.visualstudio.com     | Editor de código                       |\n\n### Conferir se instalou certo\n\nAbra o **CMD** (Windows + R, digite `cmd`, Enter) e execute:\n\n```bash\npython --version\n```\n\nDeve mostrar `Python 3.10.x` ou superior.\n\n```bash\ngit --version\n```\n\nDeve mostrar `git version 2.x.x`.\n\n```bash\ncode --version\n```\n\nDeve mostrar a versão do VS Code.\n\n---\n\n## 2. Baixar o projeto\n\n```bash\ngit clone https://github.com/BernardoMachadoSousa/sume.git\ncd sume\n```\n\n---\n\n## 3. Criar ambiente virtual e instalar dependências\n\n```bash\npython -m venv venv\nvenv\\Scripts\\activate\npip install -r requirements.txt\n```\n\n---\n\n## 4. Baixar modelo de voz (Vosk)\n\n* Link direto: https://alphacephei.com/vosk/models/vosk-model-small-pt-0.3.zip\n* Site com todos os modelos: https://alphacephei.com/vosk/models\n\nPassos:\n\n1. Extraia o `.zip` para dentro da pasta `sume`\n2. Renomeie a pasta extraída para `modelo_voz`\n\nDeve ficar assim: `C:\\Users\\seu-usuario\\sume\\modelo_voz\\`\n\n---\n\n## 5. Criar arquivo de configuração\n\n```bash\nmkdir dados\necho {\"gemini_api_key\": \"\"} > dados\\configuracoes.json\n```\n\n---\n\n## 6. Rodar o projeto\n\n```bash\npython main.py\n```\n\nSe tudo deu certo, a janela do Sumé vai abrir.\n\n---\n\n## 📁 Estrutura de pastas\n\n```\nsume/\n├── main.py                 # Inicia o app\n├── requirements.txt        # Bibliotecas necessárias\n├── core/\n│   └── nexus_core.py       # Interpreta comandos\n├── modulos/\n│   ├── memoria.py          # Memória\n│   ├── automacoes.py       # Abrir/fechar apps e sites\n│   └── ia_conversacional.py # IA\n├── utils/\n│   ├── voz.py              # Fala\n│   └── escuta.py           # Escuta\n├── interface/\n│   ├── index.html          # Tela\n│   └── assets/\n│       ├── style.css       # Visual\n│       └── script.js       # Comportamento\n└── dados/\n    └── configuracoes.json  # Chaves\n```\n\n---\n\n## 🔄 Como usar o Git\n\n### Configurar (só na primeira vez)\n\n```bash\ngit config --global user.email \"seu-email@gmail.com\"\ngit config --global user.name \"SeuNomeNoGitHub\"\n```\n\n### Antes de programar\n\n```bash\ngit pull\n```\n\n### Depois de fazer alterações\n\n```bash\ngit add .\ngit commit -m \"O que você fez\"\ngit push\n```\n\n---\n\n## 🤝 Regras da equipe\n\n1. **Sempre faça **``** antes de começar**\n2. Avise no WhatsApp o que vai mexer\n3. Teste antes de dar `git push`\n4. Não mexa no `main.py` ou `dados/configuracoes.json` sem avisar\n5. Commits em português, objetivos: `\"Adicionei comando de clima\"`\n\n---\n\n## ❗ Problemas comuns\n\n| Erro                        | Solução                                   |\n| --------------------------- | ----------------------------------------- |\n| `pip não é reconhecido`     | Reinstale o Python marcando \"Add to PATH\" |\n| PowerShell não ativa venv   | Use o **CMD**, não o PowerShell           |\n| `ModuleNotFoundError`       | `pip install nome-do-modulo`              |\n| `modelo_voz não encontrado` | O modelo Vosk não está na pasta correta   |\n\n---\n\n## 📖 Histórico do projeto\n\nConversa completa com todas as decisões e ideias:\n\nhttps://chat.deepseek.com/share/6f64u0d6s37xcameki\n\n---\n\n## 👥 Time\n\n* Bernardo Machado Sousa — Coordenação\n* Gabriel Almeida Carvalho\n* Matheus Torquato Gomes\n\n---\n\nSalve (Ctrl+S) e depois no CMD:\n\n```bash\ngit add README.md\ngit commit -m \"README final organizado\"\ngit push\n```\n\n\n## 📋 Tarefas do Sumé\n\n### ✅ Concluído\n- [x] Edge TTS (voz natural Antônio)\n- [x] Ollama + Phi-3 Mini (IA local)\n- [x] Whisper (reconhecimento de voz)\n- [x] VAD (detecção de silêncio)\n- [x] Push-to-talk (segurar Espaço)\n- [x] SQLite (substituiu JSON)\n- [x] Automações inteligentes (abrir/fechar programas)\n- [x] Pré-carregamento do Whisper\n- [x] Atalhos de desenvolvimento\n\n---\n\n## 📋 Tarefas do Sumé\n\n### ✅ Concluído\n- [x] Edge TTS (voz natural Antônio)\n- [x] Ollama + Phi-3 Mini (IA local)\n- [x] Whisper (reconhecimento de voz)\n- [x] VAD (detecção de silêncio)\n- [x] Push-to-talk (segurar Espaço)\n- [x] SQLite (substituiu JSON)\n- [x] Automações inteligentes (abrir/fechar programas)\n- [x] Pré-carregamento do Whisper\n- [x] Atalhos de desenvolvimento\n- [x] Corrigir inconsistência `nome` vs `nome_usuario`\n- [x] Sistema de logs (comandos, intents, resultados, erros)\n- [x] Remover `except: pass` (tratamento com log)\n- [x] Catálogo/cache de programas (Menu Iniciar)\n- [x] Centralizar interpretação no Core\n- [x] Tratamento padronizado de resultados (classe Resultado)\n- [x] Testes automatizados (20 testes, abre e fecha tudo)\n\n### 🔴 Fase 1 — Estabilidade e Organização\n- [x] Tudo concluído! 🎉\n\n### 🟡 Fase 2 — Preparação para Crescimento\n- [ ] Sistema de intenções (core/intents/)\n- [ ] Configurações persistentes (dados/config.json)\n- [ ] Modo desenvolvedor\n- [ ] DeepSeek API como IA \n\n### 🟢 Fase 3 — Experiência do Usuário\n- [ ] Correção inteligente de voz\n- [ ] Histórico visual de conversas\n- [ ] Atalho global Ctrl+Espaço\n- [ ] Feedback sonoro\n\n### 🔵 Fase 4 — Utilidade Real\n- [ ] Memória contextual\n- [ ] Agendamentos e lembretes\n- [ ] Busca inteligente no computador\n- [ ] Comandos compostos\n- [ ] Central de conhecimento pessoal\n\n### 🟣 Fase 5 — Escalabilidade\n- [ ] Sistema de plugins\n- [ ] Perfis de usuário\n- [ ] Dashboard administrativo\n- [ ] Camada de serviços\n- [ ] Testes automatizados (expandir cobertura)\n\n### ⚫ Fase 6 — Avançado\n- [ ] Palavra de ativação \"Sumé\"\n- [ ] OCR e leitura de tela\n- [ ] Automação de navegador\n- [ ] Modo reunião\n- [ ] Resumo automático do dia\n- [ ] Multiagentes\n"}, "11be09cb53de756728fdb6f6ccc3d2fb1861a5c1": {"t": 1785771797.0391345, "n": 5868, "h": "f3e454d9d6317c55", "c": "# ⚡ Sumé — Assistente Virtual\n\nAssistente pessoal com voz, memória e automações.\n\n---\n\n## 1. O que instalar\n\n| Ferramenta | Link                              | Observação                             |\n| ---------- | --------------------------------- | -------------------------------------- |\n| Python     | https://python.org                | **Marcar \"Add to PATH\"** na instalação |\n| Git        | https://git-scm.com/downloads/win | Instalação padrão (Next, Next, Finish) |\n| VS Code    | https://code.visualstudio.com     | Editor de código                       |\n\n### Conferir se instalou certo\n\nAbra o **CMD** (Windows + R, digite `cmd`, Enter) e execute:\n\n```bash\npython --version\n```\n\nDeve mostrar `Python 3.10.x` ou superior.\n\n```bash\ngit --version\n```\n\nDeve mostrar `git version 2.x.x`.\n\n```bash\ncode --version\n```\n\nDeve mostrar a versão do VS Code.\n\n---\n\n## 2. Baixar o projeto\n\n```bash\ngit clone https://github.com/BernardoMachadoSousa/sume.git\ncd sume\n```\n\n---\n\n## 3. Criar ambiente virtual e instalar dependências\n\n```bash\npython -m venv venv\nvenv\\Scripts\\activate\npip install -r requirements.txt\n```\n\n---\n\n## 4. Baixar modelo de voz (Vosk)\n\n* Link direto: https://alphacephei.com/vosk/models/vosk-model-small-pt-0.3.zip\n* Site com todos os modelos: https://alphacephei.com/vosk/models\n\nPassos:\n\n1. Extraia o `.zip` para dentro da pasta `sume`\n2. Renomeie a pasta extraída para `modelo_voz`\n\nDeve ficar assim: `C:\\Users\\seu-usuario\\sume\\modelo_voz\\`\n\n---\n\n## 5. Criar arquivo de configuração\n\n```bash\nmkdir dados\necho {\"gemini_api_key\": \"\"} > dados\\configuracoes.json\n```\n\n---\n\n## 6. Rodar o projeto\n\n```bash\npython main.py\n```\n\nSe tudo deu certo, a janela do Sumé vai abrir.\n\n---\n\n## 📁 Estrutura de pastas\n\n```\nsume/\n├── main.py                 # Inicia o app\n├── requirements.txt        # Bibliotecas necessárias\n├── core/\n│   └── nexus_core.py       # Interpreta comandos\n├── modulos/\n│   ├── memoria.py          # Memória\n│   ├── automacoes.py       # Abrir/fechar apps e sites\n│   └── ia_conversacional.py # IA\n├── utils/\n│   ├── voz.py              # Fala\n│   └── escuta.py           # Escuta\n├── interface/\n│   ├── index.html          # Tela\n│   └── assets/\n│       ├── style.css       # Visual\n│       └── script.js       # Comportamento\n└── dados/\n    └── configuracoes.json  # Chaves\n```\n\n---\n\n## 🔄 Como usar o Git\n\n### Configurar (só na primeira vez)\n\n```bash\ngit config --global user.email \"seu-email@gmail.com\"\ngit config --global user.name \"SeuNomeNoGitHub\"\n```\n\n### Antes de programar\n\n```bash\ngit pull\n```\n\n### Depois de fazer alterações\n\n```bash\ngit add .\ngit commit -m \"O que você fez\"\ngit push\n```\n\n---\n\n## 🤝 Regras da equipe\n\n1. **Sempre faça **``** antes de começar**\n2. Avise no WhatsApp o que vai mexer\n3. Teste antes de dar `git push`\n4. Não mexa no `main.py` ou `dados/configuracoes.json` sem avisar\n5. Commits em português, objetivos: `\"Adicionei comando de clima\"`\n\n---\n\n## ❗ Problemas comuns\n\n| Erro                        | Solução                                   |\n| --------------------------- | ----------------------------------------- |\n| `pip não é reconhecido`     | Reinstale o Python marcando \"Add to PATH\" |\n| PowerShell não ativa venv   | Use o **CMD**, não o PowerShell           |\n| `ModuleNotFoundError`       | `pip install nome-do-modulo`              |\n| `modelo_voz não encontrado` | O modelo Vosk não está na pasta correta   |\n\n---\n\n## 📖 Histórico do projeto\n\nConversa completa com todas as decisões e ideias:\n\nhttps://chat.deepseek.com/share/6f64u0d6s37xcameki\n\n---\n\n## 👥 Time\n\n* Bernardo Machado Sousa — Coordenação\n* Gabriel Almeida Carvalho\n* Matheus Torquato Gomes\n\n---\n\nSalve (Ctrl+S) e depois no CMD:\n\n```bash\ngit add README.md\ngit commit -m \"README final organizado\"\ngit push\n```\n\n\n## 📋 Tarefas do Sumé\n\n### ✅ Concluído\n- [x] Edge TTS (voz natural Antônio)\n- [x] Ollama + Phi-3 Mini (IA local)\n- [x] Whisper (reconhecimento de voz)\n- [x] VAD (detecção de silêncio)\n- [x] Push-to-talk (segurar Espaço)\n- [x] SQLite (substituiu JSON)\n- [x] Automações inteligentes (abrir/fechar programas)\n- [x] Pré-carregamento do Whisper\n- [x] Atalhos de desenvolvimento\n\n---\n\n## 📋 Tarefas do Sumé\n\n### ✅ Concluído\n- [x] Edge TTS (voz natural Antônio)\n- [x] Ollama + Phi-3 Mini (IA local)\n- [x] Whisper (reconhecimento de voz)\n- [x] VAD (detecção de silêncio)\n- [x] Push-to-talk (segurar Espaço)\n- [x] SQLite (substituiu JSON)\n- [x] Automações inteligentes (abrir/fechar programas)\n- [x] Pré-carregamento do Whisper\n- [x] Atalhos de desenvolvimento\n- [x] Corrigir inconsistência `nome` vs `nome_usuario`\n- [x] Sistema de logs (comandos, intents, resultados, erros)\n- [x] Remover `except: pass` (tratamento com log)\n- [x] Catálogo/cache de programas (Menu Iniciar)\n- [x] Centralizar interpretação no Core\n- [x] Tratamento padronizado de resultados (classe Resultado)\n- [x] Testes automatizados (20 testes, abre e fecha tudo)\n\n### 🔴 Fase 1 — Estabilidade e Organização\n- [x] Tudo concluído! 🎉\n\n### 🟡 Fase 2 — Preparação para Crescimento\n- [ ] Sistema de intenções (core/intents/)\n- [ ] Configurações persistentes (dados/config.json)\n- [ ] Modo desenvolvedor\n- [ ] DeepSeek API como IA principal\n\n### 🟢 Fase 3 — Experiência do Usuário\n- [ ] Correção inteligente de voz\n- [ ] Histórico visual de conversas\n- [ ] Atalho global Ctrl+Espaço\n- [ ] Feedback sonoro\n\n### 🔵 Fase 4 — Utilidade Real\n- [ ] Memória contextual\n- [ ] Agendamentos e lembretes\n- [ ] Busca inteligente no computador\n- [ ] Comandos compostos\n- [ ] Central de conhecimento pessoal\n\n### 🟣 Fase 5 — Escalabilidade\n- [ ] Sistema de plugins\n- [ ] Perfis de usuário\n- [ ] Dashboard administrativo\n- [ ] Camada de serviços\n- [ ] Testes automatizados (expandir cobertura)\n\n### ⚫ Fase 6 — Avançado\n- [ ] Palavra de ativação \"Sumé\"\n- [ ] OCR e leitura de tela\n- [ ] Automação de navegador\n- [ ] Modo reunião\n- [ ] Resumo automático do dia\n- [ ] Multiagentes\n"}, "50b9ce462dd55cfaf299b563eae979a5de1f7e31": {"t": 1785771799.4220424, "n": 5801, "h": "4124dd23a49f39c1", "c": "# ⚡ Sumé — Assistente Virtual\n\nAssistente pessoal com voz, memória e automações.\n\n---\n\n## 1. O que instalar\n\n| Ferramenta | Link                              | Observação                             |\n| ---------- | --------------------------------- | -------------------------------------- |\n| Python     | https://python.org                | **Marcar \"Add to PATH\"** na instalação |\n| Git        | https://git-scm.com/downloads/win | Instalação padrão (Next, Next, Finish) |\n| VS Code    | https://code.visualstudio.com     | Editor de código                       |\n\n### Conferir se instalou certo\n\nAbra o **CMD** (Windows + R, digite `cmd`, Enter) e execute:\n\n```bash\npython --version\n```\n\nDeve mostrar `Python 3.10.x` ou superior.\n\n```bash\ngit --version\n```\n\nDeve mostrar `git version 2.x.x`.\n\n```bash\ncode --version\n```\n\nDeve mostrar a versão do VS Code.\n\n---\n\n## 2. Baixar o projeto\n\n```bash\ngit clone https://github.com/BernardoMachadoSousa/sume.git\ncd sume\n```\n\n---\n\n## 3. Criar ambiente virtual e instalar dependências\n\n```bash\npython -m venv venv\nvenv\\Scripts\\activate\npip install -r requirements.txt\n```\n\n---\n\n## 4. Baixar modelo de voz (Vosk)\n\n* Link direto: https://alphacephei.com/vosk/models/vosk-model-small-pt-0.3.zip\n* Site com todos os modelos: https://alphacephei.com/vosk/models\n\nPassos:\n\n1. Extraia o `.zip` para dentro da pasta `sume`\n2. Renomeie a pasta extraída para `modelo_voz`\n\nDeve ficar assim: `C:\\Users\\seu-usuario\\sume\\modelo_voz\\`\n\n---\n\n## 5. Criar arquivo de configuração\n\n```bash\nmkdir dados\necho {\"gemini_api_key\": \"\"} > dados\\configuracoes.json\n```\n\n---\n\n## 6. Rodar o projeto\n\n```bash\npython main.py\n```\n\nSe tudo deu certo, a janela do Sumé vai abrir.\n\n---\n\n## 📁 Estrutura de pastas\n\n```\nsume/\n├── main.py                 # Inicia o app\n├── requirements.txt        # Bibliotecas necessárias\n├── core/\n│   └── nexus_core.py       # Interpreta comandos\n├── modulos/\n│   ├── memoria.py          # Memória\n│   ├── automacoes.py       # Abrir/fechar apps e sites\n│   └── ia_conversacional.py # IA\n├── utils/\n│   ├── voz.py              # Fala\n│   └── escuta.py           # Escuta\n├── interface/\n│   ├── index.html          # Tela\n│   └── assets/\n│       ├── style.css       # Visual\n│       └── script.js       # Comportamento\n└── dados/\n    └── configuracoes.json  # Chaves\n```\n\n---\n\n## 🔄 Como usar o Git\n\n### Configurar (só na primeira vez)\n\n```bash\ngit config --global user.email \"seu-email@gmail.com\"\ngit config --global user.name \"SeuNomeNoGitHub\"\n```\n\n### Antes de programar\n\n```bash\ngit pull\n```\n\n### Depois de fazer alterações\n\n```bash\ngit add .\ngit commit -m \"O que você fez\"\ngit push\n```\n\n---\n\n## 🤝 Regras da equipe\n\n1. **Sempre faça **``** antes de começar**\n2. Avise no WhatsApp o que vai mexer\n3. Teste antes de dar `git push`\n4. Não mexa no `main.py` ou `dados/configuracoes.json` sem avisar\n5. Commits em português, objetivos: `\"Adicionei comando de clima\"`\n\n---\n\n## ❗ Problemas comuns\n\n| Erro                        | Solução                                   |\n| --------------------------- | ----------------------------------------- |\n| `pip não é reconhecido`     | Reinstale o Python marcando \"Add to PATH\" |\n| PowerShell não ativa venv   | Use o **CMD**, não o PowerShell           |\n| `ModuleNotFoundError`       | `pip install nome-do-modulo`              |\n| `modelo_voz não encontrado` | O modelo Vosk não está na pasta correta   |\n\n---\n\n## 📖 Histórico do projeto\n\nConversa completa com todas as decisões e ideias:\n\nhttps://chat.deepseek.com/share/6f64u0d6s37xcameki\n\n---\n\n## 👥 Time\n\n* Bernardo Machado Sousa — Coordenação\n* Gabriel Almeida Carvalho\n* Matheus Torquato Gomes\n\n---\n\nSalve (Ctrl+S) e depois no CMD:\n\n```bash\ngit add README.md\ngit commit -m \"README final organizado\"\ngit push\n```\n\n\n## 📋 Tarefas do Sumé\n\n### ✅ Concluído\n- [x] Edge TTS (voz natural Antônio)\n- [x] Ollama + Phi-3 Mini (IA local)\n- [x] Whisper (reconhecimento de voz)\n- [x] VAD (detecção de silêncio)\n- [x] Push-to-talk (segurar Espaço)\n- [x] SQLite (substituiu JSON)\n- [x] Automações inteligentes (abrir/fechar programas)\n- [x] Pré-carregamento do Whisper\n- [x] Atalhos de desenvolvimento\n\n---\n\n## 📋 Tarefas do Sumé\n\n### ✅ Concluído\n- [x] Edge TTS (voz natural Antônio)\n- [x] Ollama + Phi-3 Mini (IA local)\n- [x] Whisper (reconhecimento de voz)\n- [x] VAD (detecção de silêncio)\n- [x] Push-to-talk (segurar Espaço)\n- [x] SQLite (substituiu JSON)\n- [x] Automações inteligentes (abrir/fechar programas)\n- [x] Pré-carregamento do Whisper\n- [x] Atalhos de desenvolvimento\n- [x] Corrigir inconsistência `nome` vs `nome_usuario`\n- [x] Sistema de logs (comandos, intents, resultados, erros)\n- [x] Remover `except: pass` (tratamento com log)\n- [x] Catálogo/cache de programas (Menu Iniciar)\n\n---\n\n### 🔴 Fase 1 — Estabilidade e Organização\n- [ ] **Centralizar interpretação no Core** (remover do memoria.py)\n- [ ] **Tratamento padronizado de resultados** (classe Resultado)\n\n### 🟡 Fase 2 — Preparação para Crescimento\n- [ ] Sistema de intenções (core/intents/)\n- [ ] Configurações persistentes (dados/config.json)\n- [ ] Modo desenvolvedor\n- [ ] DeepSeek API como IA principal\n\n### 🟢 Fase 3 — Experiência do Usuário\n- [ ] Correção inteligente de voz\n- [ ] Histórico visual de conversas\n- [ ] Atalho global Ctrl+Espaço\n- [ ] Feedback sonoro\n\n### 🔵 Fase 4 — Utilidade Real\n- [ ] Memória contextual\n- [ ] Agendamentos e lembretes\n- [ ] Busca inteligente no computador\n- [ ] Comandos compostos\n- [ ] Central de conhecimento pessoal\n\n### 🟣 Fase 5 — Escalabilidade\n- [ ] Sistema de plugins\n- [ ] Perfis de usuário\n- [ ] Dashboard administrativo\n- [ ] Camada de serviços\n- [ ] Testes automatizados\n\n### ⚫ Fase 6 — Avançado\n- [ ] Palavra de ativação \"Sumé\"\n- [ ] OCR e leitura de tela\n- [ ] Automação de navegador\n- [ ] Modo reunião\n- [ ] Resumo automático do dia\n- [ ] Multiagentes"}, "d0c70fb2bf84144094c38ad5eff9301b9adb9688": {"t": 1785771800.7650795, "n": 5722, "h": "1962f9d12988cf73", "c": "# ⚡ Sumé — Assistente Virtual\n\nAssistente pessoal com voz, memória e automações.\n\n---\n\n## 1. O que instalar\n\n| Ferramenta | Link                              | Observação                             |\n| ---------- | --------------------------------- | -------------------------------------- |\n| Python     | https://python.org                | **Marcar \"Add to PATH\"** na instalação |\n| Git        | https://git-scm.com/downloads/win | Instalação padrão (Next, Next, Finish) |\n| VS Code    | https://code.visualstudio.com     | Editor de código                       |\n\n### Conferir se instalou certo\n\nAbra o **CMD** (Windows + R, digite `cmd`, Enter) e execute:\n\n```bash\npython --version\n```\n\nDeve mostrar `Python 3.10.x` ou superior.\n\n```bash\ngit --version\n```\n\nDeve mostrar `git version 2.x.x`.\n\n```bash\ncode --version\n```\n\nDeve mostrar a versão do VS Code.\n\n---\n\n## 2. Baixar o projeto\n\n```bash\ngit clone https://github.com/BernardoMachadoSousa/sume.git\ncd sume\n```\n\n---\n\n## 3. Criar ambiente virtual e instalar dependências\n\n```bash\npython -m venv venv\nvenv\\Scripts\\activate\npip install -r requirements.txt\n```\n\n---\n\n## 4. Baixar modelo de voz (Vosk)\n\n* Link direto: https://alphacephei.com/vosk/models/vosk-model-small-pt-0.3.zip\n* Site com todos os modelos: https://alphacephei.com/vosk/models\n\nPassos:\n\n1. Extraia o `.zip` para dentro da pasta `sume`\n2. Renomeie a pasta extraída para `modelo_voz`\n\nDeve ficar assim: `C:\\Users\\seu-usuario\\sume\\modelo_voz\\`\n\n---\n\n## 5. Criar arquivo de configuração\n\n```bash\nmkdir dados\necho {\"gemini_api_key\": \"\"} > dados\\configuracoes.json\n```\n\n---\n\n## 6. Rodar o projeto\n\n```bash\npython main.py\n```\n\nSe tudo deu certo, a janela do Sumé vai abrir.\n\n---\n\n## 📁 Estrutura de pastas\n\n```\nsume/\n├── main.py                 # Inicia o app\n├── requirements.txt        # Bibliotecas necessárias\n├── core/\n│   └── nexus_core.py       # Interpreta comandos\n├── modulos/\n│   ├── memoria.py          # Memória\n│   ├── automacoes.py       # Abrir/fechar apps e sites\n│   └── ia_conversacional.py # IA\n├── utils/\n│   ├── voz.py              # Fala\n│   └── escuta.py           # Escuta\n├── interface/\n│   ├── index.html          # Tela\n│   └── assets/\n│       ├── style.css       # Visual\n│       └── script.js       # Comportamento\n└── dados/\n    └── configuracoes.json  # Chaves\n```\n\n---\n\n## 🔄 Como usar o Git\n\n### Configurar (só na primeira vez)\n\n```bash\ngit config --global user.email \"seu-email@gmail.com\"\ngit config --global user.name \"SeuNomeNoGitHub\"\n```\n\n### Antes de programar\n\n```bash\ngit pull\n```\n\n### Depois de fazer alterações\n\n```bash\ngit add .\ngit commit -m \"O que você fez\"\ngit push\n```\n\n---\n\n## 🤝 Regras da equipe\n\n1. **Sempre faça **``** antes de começar**\n2. Avise no WhatsApp o que vai mexer\n3. Teste antes de dar `git push`\n4. Não mexa no `main.py` ou `dados/configuracoes.json` sem avisar\n5. Commits em português, objetivos: `\"Adicionei comando de clima\"`\n\n---\n\n## ❗ Problemas comuns\n\n| Erro                        | Solução                                   |\n| --------------------------- | ----------------------------------------- |\n| `pip não é reconhecido`     | Reinstale o Python marcando \"Add to PATH\" |\n| PowerShell não ativa venv   | Use o **CMD**, não o PowerShell           |\n| `ModuleNotFoundError`       | `pip install nome-do-modulo`              |\n| `modelo_voz não encontrado` | O modelo Vosk não está na pasta correta   |\n\n---\n\n## 📖 Histórico do projeto\n\nConversa completa com todas as decisões e ideias:\n\nhttps://chat.deepseek.com/share/6f64u0d6s37xcameki\n\n---\n\n## 👥 Time\n\n* Bernardo Machado Sousa — Coordenação\n* Gabriel Almeida Carvalho\n* Matheus Torquato Gomes\n\n---\n\nSalve (Ctrl+S) e depois no CMD:\n\n```bash\ngit add README.md\ngit commit -m \"README final organizado\"\ngit push\n```\n\n\n## 📋 Tarefas do Sumé\n\n### ✅ Concluído\n- [x] Edge TTS (voz natural Antônio)\n- [x] Ollama + Phi-3 Mini (IA local)\n- [x] Whisper (reconhecimento de voz)\n- [x] VAD (detecção de silêncio)\n- [x] Push-to-talk (segurar Espaço)\n- [x] SQLite (substituiu JSON)\n- [x] Automações inteligentes (abrir/fechar programas)\n- [x] Pré-carregamento do Whisper\n- [x] Atalhos de desenvolvimento\n\n---\n\n### 🔴 Fase 1 — Estabilidade e Organização\n- [x] **Corrigir inconsistência `nome` vs `nome_usuario`**\n- [ ] **Sistema de logs** (comandos, intents, resultados, tempo, erros)\n- [ ] **Centralizar interpretação no Core** (remover do memoria.py)\n- [ ] **Substituir todos `except: pass`** por tratamento com log\n- [ ] **Catálogo/cache de programas** (escanear Menu Iniciar uma vez)\n- [ ] **Tratamento padronizado de resultados** (classe Resultado)\n\n### 🟡 Fase 2 — Preparação para Crescimento\n- [ ] **Sistema de intenções** (core/intents/ com módulos separados)\n- [ ] **Configurações persistentes** (dados/config.json)\n- [ ] **Modo desenvolvedor** (painel de depuração)\n- [ ] **DeepSeek API** como IA principal (fallback Phi-3)\n\n### 🟢 Fase 3 — Experiência do Usuário\n- [ ] **Correção inteligente de voz** (IA corrige erros do Whisper)\n- [ ] **Histórico visual** de conversas na interface\n- [ ] **Atalho global** Ctrl+Espaço\n- [ ] **Feedback sonoro** (início/fim da escuta, erro)\n\n### 🔵 Fase 4 — Utilidade Real\n- [ ] **Memória contextual** (projetos, objetivos, preferências)\n- [ ] **Agendamentos e lembretes**\n- [ ] **Busca inteligente** no computador\n- [ ] **Comandos compostos**\n- [ ] **Central de conhecimento pessoal**\n\n### 🟣 Fase 5 — Escalabilidade\n- [ ] Sistema de plugins\n- [ ] Perfis de usuário\n- [ ] Dashboard administrativo\n- [ ] Camada de serviços\n- [ ] Testes automatizados\n\n### ⚫ Fase 6 — Avançado (só depois das anteriores)\n- [ ] Palavra de ativação \"Sumé\"\n- [ ] OCR e leitura de tela\n- [ ] Automação de navegador\n- [ ] Modo reunião\n- [ ] Resumo automático do dia\n- [ ] Multiagentes"}, "2847713fb62840bac1bf8ff708b3553464a06f3d": {"t": 1785771802.1859393, "n": 5722, "h": "ed6242aa59f6e595", "c": "# ⚡ Sumé — Assistente Virtual\n\nAssistente pessoal com voz, memória e automações.\n\n---\n\n## 1. O que instalar\n\n| Ferramenta | Link                              | Observação                             |\n| ---------- | --------------------------------- | -------------------------------------- |\n| Python     | https://python.org                | **Marcar \"Add to PATH\"** na instalação |\n| Git        | https://git-scm.com/downloads/win | Instalação padrão (Next, Next, Finish) |\n| VS Code    | https://code.visualstudio.com     | Editor de código                       |\n\n### Conferir se instalou certo\n\nAbra o **CMD** (Windows + R, digite `cmd`, Enter) e execute:\n\n```bash\npython --version\n```\n\nDeve mostrar `Python 3.10.x` ou superior.\n\n```bash\ngit --version\n```\n\nDeve mostrar `git version 2.x.x`.\n\n```bash\ncode --version\n```\n\nDeve mostrar a versão do VS Code.\n\n---\n\n## 2. Baixar o projeto\n\n```bash\ngit clone https://github.com/BernardoMachadoSousa/sume.git\ncd sume\n```\n\n---\n\n## 3. Criar ambiente virtual e instalar dependências\n\n```bash\npython -m venv venv\nvenv\\Scripts\\activate\npip install -r requirements.txt\n```\n\n---\n\n## 4. Baixar modelo de voz (Vosk)\n\n* Link direto: https://alphacephei.com/vosk/models/vosk-model-small-pt-0.3.zip\n* Site com todos os modelos: https://alphacephei.com/vosk/models\n\nPassos:\n\n1. Extraia o `.zip` para dentro da pasta `sume`\n2. Renomeie a pasta extraída para `modelo_voz`\n\nDeve ficar assim: `C:\\Users\\seu-usuario\\sume\\modelo_voz\\`\n\n---\n\n## 5. Criar arquivo de configuração\n\n```bash\nmkdir dados\necho {\"gemini_api_key\": \"\"} > dados\\configuracoes.json\n```\n\n---\n\n## 6. Rodar o projeto\n\n```bash\npython main.py\n```\n\nSe tudo deu certo, a janela do Sumé vai abrir.\n\n---\n\n## 📁 Estrutura de pastas\n\n```\nsume/\n├── main.py                 # Inicia o app\n├── requirements.txt        # Bibliotecas necessárias\n├── core/\n│   └── nexus_core.py       # Interpreta comandos\n├── modulos/\n│   ├── memoria.py          # Memória\n│   ├── automacoes.py       # Abrir/fechar apps e sites\n│   └── ia_conversacional.py # IA\n├── utils/\n│   ├── voz.py              # Fala\n│   └── escuta.py           # Escuta\n├── interface/\n│   ├── index.html          # Tela\n│   └── assets/\n│       ├── style.css       # Visual\n│       └── script.js       # Comportamento\n└── dados/\n    └── configuracoes.json  # Chaves\n```\n\n---\n\n## 🔄 Como usar o Git\n\n### Configurar (só na primeira vez)\n\n```bash\ngit config --global user.email \"seu-email@gmail.com\"\ngit config --global user.name \"SeuNomeNoGitHub\"\n```\n\n### Antes de programar\n\n```bash\ngit pull\n```\n\n### Depois de fazer alterações\n\n```bash\ngit add .\ngit commit -m \"O que você fez\"\ngit push\n```\n\n---\n\n## 🤝 Regras da equipe\n\n1. **Sempre faça **``** antes de começar**\n2. Avise no WhatsApp o que vai mexer\n3. Teste antes de dar `git push`\n4. Não mexa no `main.py` ou `dados/configuracoes.json` sem avisar\n5. Commits em português, objetivos: `\"Adicionei comando de clima\"`\n\n---\n\n## ❗ Problemas comuns\n\n| Erro                        | Solução                                   |\n| --------------------------- | ----------------------------------------- |\n| `pip não é reconhecido`     | Reinstale o Python marcando \"Add to PATH\" |\n| PowerShell não ativa venv   | Use o **CMD**, não o PowerShell           |\n| `ModuleNotFoundError`       | `pip install nome-do-modulo`              |\n| `modelo_voz não encontrado` | O modelo Vosk não está na pasta correta   |\n\n---\n\n## 📖 Histórico do projeto\n\nConversa completa com todas as decisões e ideias:\n\nhttps://chat.deepseek.com/share/6f64u0d6s37xcameki\n\n---\n\n## 👥 Time\n\n* Bernardo Machado Sousa — Coordenação\n* Gabriel Almeida Carvalho\n* Matheus Torquato Gomes\n\n---\n\nSalve (Ctrl+S) e depois no CMD:\n\n```bash\ngit add README.md\ngit commit -m \"README final organizado\"\ngit push\n```\n\n\n## 📋 Tarefas do Sumé\n\n### ✅ Concluído\n- [x] Edge TTS (voz natural Antônio)\n- [x] Ollama + Phi-3 Mini (IA local)\n- [x] Whisper (reconhecimento de voz)\n- [x] VAD (detecção de silêncio)\n- [x] Push-to-talk (segurar Espaço)\n- [x] SQLite (substituiu JSON)\n- [x] Automações inteligentes (abrir/fechar programas)\n- [x] Pré-carregamento do Whisper\n- [x] Atalhos de desenvolvimento\n\n---\n\n### 🔴 Fase 1 — Estabilidade e Organização\n- [ ] **Corrigir inconsistência `nome` vs `nome_usuario`**\n- [ ] **Sistema de logs** (comandos, intents, resultados, tempo, erros)\n- [ ] **Centralizar interpretação no Core** (remover do memoria.py)\n- [ ] **Substituir todos `except: pass`** por tratamento com log\n- [ ] **Catálogo/cache de programas** (escanear Menu Iniciar uma vez)\n- [ ] **Tratamento padronizado de resultados** (classe Resultado)\n\n### 🟡 Fase 2 — Preparação para Crescimento\n- [ ] **Sistema de intenções** (core/intents/ com módulos separados)\n- [ ] **Configurações persistentes** (dados/config.json)\n- [ ] **Modo desenvolvedor** (painel de depuração)\n- [ ] **DeepSeek API** como IA principal (fallback Phi-3)\n\n### 🟢 Fase 3 — Experiência do Usuário\n- [ ] **Correção inteligente de voz** (IA corrige erros do Whisper)\n- [ ] **Histórico visual** de conversas na interface\n- [ ] **Atalho global** Ctrl+Espaço\n- [ ] **Feedback sonoro** (início/fim da escuta, erro)\n\n### 🔵 Fase 4 — Utilidade Real\n- [ ] **Memória contextual** (projetos, objetivos, preferências)\n- [ ] **Agendamentos e lembretes**\n- [ ] **Busca inteligente** no computador\n- [ ] **Comandos compostos**\n- [ ] **Central de conhecimento pessoal**\n\n### 🟣 Fase 5 — Escalabilidade\n- [ ] Sistema de plugins\n- [ ] Perfis de usuário\n- [ ] Dashboard administrativo\n- [ ] Camada de serviços\n- [ ] Testes automatizados\n\n### ⚫ Fase 6 — Avançado (só depois das anteriores)\n- [ ] Palavra de ativação \"Sumé\"\n- [ ] OCR e leitura de tela\n- [ ] Automação de navegador\n- [ ] Modo reunião\n- [ ] Resumo automático do dia\n- [ ] Multiagentes"}, "f0e379bfdc161d3a3626df12ac4a3554409c90d3": {"t": 1785771804.4874449, "n": 5177, "h": "16c761c4264c1fb4", "c": "# ⚡ Sumé — Assistente Virtual\n\nAssistente pessoal com voz, memória e automações.\n\n---\n\n## 1. O que instalar\n\n| Ferramenta | Link                              | Observação                             |\n| ---------- | --------------------------------- | -------------------------------------- |\n| Python     | https://python.org                | **Marcar \"Add to PATH\"** na instalação |\n| Git        | https://git-scm.com/downloads/win | Instalação padrão (Next, Next, Finish) |\n| VS Code    | https://code.visualstudio.com     | Editor de código                       |\n\n### Conferir se instalou certo\n\nAbra o **CMD** (Windows + R, digite `cmd`, Enter) e execute:\n\n```bash\npython --version\n```\n\nDeve mostrar `Python 3.10.x` ou superior.\n\n```bash\ngit --version\n```\n\nDeve mostrar `git version 2.x.x`.\n\n```bash\ncode --version\n```\n\nDeve mostrar a versão do VS Code.\n\n---\n\n## 2. Baixar o projeto\n\n```bash\ngit clone https://github.com/BernardoMachadoSousa/sume.git\ncd sume\n```\n\n---\n\n## 3. Criar ambiente virtual e instalar dependências\n\n```bash\npython -m venv venv\nvenv\\Scripts\\activate\npip install -r requirements.txt\n```\n\n---\n\n## 4. Baixar modelo de voz (Vosk)\n\n* Link direto: https://alphacephei.com/vosk/models/vosk-model-small-pt-0.3.zip\n* Site com todos os modelos: https://alphacephei.com/vosk/models\n\nPassos:\n\n1. Extraia o `.zip` para dentro da pasta `sume`\n2. Renomeie a pasta extraída para `modelo_voz`\n\nDeve ficar assim: `C:\\Users\\seu-usuario\\sume\\modelo_voz\\`\n\n---\n\n## 5. Criar arquivo de configuração\n\n```bash\nmkdir dados\necho {\"gemini_api_key\": \"\"} > dados\\configuracoes.json\n```\n\n---\n\n## 6. Rodar o projeto\n\n```bash\npython main.py\n```\n\nSe tudo deu certo, a janela do Sumé vai abrir.\n\n---\n\n## 📁 Estrutura de pastas\n\n```\nsume/\n├── main.py                 # Inicia o app\n├── requirements.txt        # Bibliotecas necessárias\n├── core/\n│   └── nexus_core.py       # Interpreta comandos\n├── modulos/\n│   ├── memoria.py          # Memória\n│   ├── automacoes.py       # Abrir/fechar apps e sites\n│   └── ia_conversacional.py # IA\n├── utils/\n│   ├── voz.py              # Fala\n│   └── escuta.py           # Escuta\n├── interface/\n│   ├── index.html          # Tela\n│   └── assets/\n│       ├── style.css       # Visual\n│       └── script.js       # Comportamento\n└── dados/\n    └── configuracoes.json  # Chaves\n```\n\n---\n\n## 🔄 Como usar o Git\n\n### Configurar (só na primeira vez)\n\n```bash\ngit config --global user.email \"seu-email@gmail.com\"\ngit config --global user.name \"SeuNomeNoGitHub\"\n```\n\n### Antes de programar\n\n```bash\ngit pull\n```\n\n### Depois de fazer alterações\n\n```bash\ngit add .\ngit commit -m \"O que você fez\"\ngit push\n```\n\n---\n\n## 🤝 Regras da equipe\n\n1. **Sempre faça **``** antes de começar**\n2. Avise no WhatsApp o que vai mexer\n3. Teste antes de dar `git push`\n4. Não mexa no `main.py` ou `dados/configuracoes.json` sem avisar\n5. Commits em português, objetivos: `\"Adicionei comando de clima\"`\n\n---\n\n## ❗ Problemas comuns\n\n| Erro                        | Solução                                   |\n| --------------------------- | ----------------------------------------- |\n| `pip não é reconhecido`     | Reinstale o Python marcando \"Add to PATH\" |\n| PowerShell não ativa venv   | Use o **CMD**, não o PowerShell           |\n| `ModuleNotFoundError`       | `pip install nome-do-modulo`              |\n| `modelo_voz não encontrado` | O modelo Vosk não está na pasta correta   |\n\n---\n\n## 📖 Histórico do projeto\n\nConversa completa com todas as decisões e ideias:\n\nhttps://chat.deepseek.com/share/6f64u0d6s37xcameki\n\n---\n\n## 👥 Time\n\n* Bernardo Machado Sousa — Coordenação\n* Gabriel Almeida Carvalho\n* Matheus Torquato Gomes\n\n---\n\nSalve (Ctrl+S) e depois no CMD:\n\n```bash\ngit add README.md\ngit commit -m \"README final organizado\"\ngit push\n```\n\n\n## 📝 O que já foi feito e o que falta\n\n### 🔴 Prioridade alta\n- [x] Substituir voz robótica por **Edge TTS** (voz natural, grátis)\n- [x] Integrar **IA local com Ollama** (Phi-3 Mini) para conversas offline\n\n### 🟡 Prioridade média\n- [ ] Criar **atalho global** (Ctrl+Espaço) para abrir/fechar o Sumé\n- [ ] Fazer o Sumé **iniciar junto com o Windows**\n- [x] Implementar **VAD** (detecção de silêncio) para processar comandos automaticamente\n- [x] Substituir Vosk por **Whisper** (reconhecimento de voz preciso)\n- [x] **Push-to-talk** (segurar Espaço para falar)\n- [x] Migrar memória de **JSON para SQLite** (mais robusto)\n- [ ] Adicionar **confirmação** antes de ações perigosas (ex: fechar apps)\n\n### 🟢 Futuro\n- [ ] **Leitura de tela** com OCR (\"Sumé, o que está na minha tela?\")\n- [ ] **Sistema de plugins/skills** para adicionar funções sem mexer no core\n- [ ] **Automação de navegador** (Playwright) para pesquisar e interagir com sites\n- [ ] **Dashboard completo** com chat, tarefas, calendário e status do PC\n- [ ] **Integração com Alexa** (Wake-on-LAN para ligar o PC)\n- [ ] **Visão computacional** com câmera\n- [ ] **Integração com Spotify, WhatsApp, Gmail**\n\n### 💡 Ideias\n- [ ] Modo mãos-livres total (palavra de ativação \"Sumé\")\n- [ ] Múltiplos idiomas (inglês, espanhol)\n- [ ] Agentes especializados (programador, pesquisador, estudos)\n- [ ] Interface com temas customizáveis\n- [ ] Histórico de conversas com busca"}, "a659385156aeb9cf14b83e8772c00d49f3fc572a": {"t": 1785771806.2990265, "n": 5077, "h": "6199f43b5be11dea", "c": "# ⚡ Sumé — Assistente Virtual\n\nAssistente pessoal com voz, memória e automações.\n\n---\n\n## 1. O que instalar\n\n| Ferramenta | Link                              | Observação                             |\n| ---------- | --------------------------------- | -------------------------------------- |\n| Python     | https://python.org                | **Marcar \"Add to PATH\"** na instalação |\n| Git        | https://git-scm.com/downloads/win | Instalação padrão (Next, Next, Finish) |\n| VS Code    | https://code.visualstudio.com     | Editor de código                       |\n\n### Conferir se instalou certo\n\nAbra o **CMD** (Windows + R, digite `cmd`, Enter) e execute:\n\n```bash\npython --version\n```\n\nDeve mostrar `Python 3.10.x` ou superior.\n\n```bash\ngit --version\n```\n\nDeve mostrar `git version 2.x.x`.\n\n```bash\ncode --version\n```\n\nDeve mostrar a versão do VS Code.\n\n---\n\n## 2. Baixar o projeto\n\n```bash\ngit clone https://github.com/BernardoMachadoSousa/sume.git\ncd sume\n```\n\n---\n\n## 3. Criar ambiente virtual e instalar dependências\n\n```bash\npython -m venv venv\nvenv\\Scripts\\activate\npip install -r requirements.txt\n```\n\n---\n\n## 4. Baixar modelo de voz (Vosk)\n\n* Link direto: https://alphacephei.com/vosk/models/vosk-model-small-pt-0.3.zip\n* Site com todos os modelos: https://alphacephei.com/vosk/models\n\nPassos:\n\n1. Extraia o `.zip` para dentro da pasta `sume`\n2. Renomeie a pasta extraída para `modelo_voz`\n\nDeve ficar assim: `C:\\Users\\seu-usuario\\sume\\modelo_voz\\`\n\n---\n\n## 5. Criar arquivo de configuração\n\n```bash\nmkdir dados\necho {\"gemini_api_key\": \"\"} > dados\\configuracoes.json\n```\n\n---\n\n## 6. Rodar o projeto\n\n```bash\npython main.py\n```\n\nSe tudo deu certo, a janela do Sumé vai abrir.\n\n---\n\n## 📁 Estrutura de pastas\n\n```\nsume/\n├── main.py                 # Inicia o app\n├── requirements.txt        # Bibliotecas necessárias\n├── core/\n│   └── nexus_core.py       # Interpreta comandos\n├── modulos/\n│   ├── memoria.py          # Memória\n│   ├── automacoes.py       # Abrir/fechar apps e sites\n│   └── ia_conversacional.py # IA\n├── utils/\n│   ├── voz.py              # Fala\n│   └── escuta.py           # Escuta\n├── interface/\n│   ├── index.html          # Tela\n│   └── assets/\n│       ├── style.css       # Visual\n│       └── script.js       # Comportamento\n└── dados/\n    └── configuracoes.json  # Chaves\n```\n\n---\n\n## 🔄 Como usar o Git\n\n### Configurar (só na primeira vez)\n\n```bash\ngit config --global user.email \"seu-email@gmail.com\"\ngit config --global user.name \"SeuNomeNoGitHub\"\n```\n\n### Antes de programar\n\n```bash\ngit pull\n```\n\n### Depois de fazer alterações\n\n```bash\ngit add .\ngit commit -m \"O que você fez\"\ngit push\n```\n\n---\n\n## 🤝 Regras da equipe\n\n1. **Sempre faça **``** antes de começar**\n2. Avise no WhatsApp o que vai mexer\n3. Teste antes de dar `git push`\n4. Não mexa no `main.py` ou `dados/configuracoes.json` sem avisar\n5. Commits em português, objetivos: `\"Adicionei comando de clima\"`\n\n---\n\n## ❗ Problemas comuns\n\n| Erro                        | Solução                                   |\n| --------------------------- | ----------------------------------------- |\n| `pip não é reconhecido`     | Reinstale o Python marcando \"Add to PATH\" |\n| PowerShell não ativa venv   | Use o **CMD**, não o PowerShell           |\n| `ModuleNotFoundError`       | `pip install nome-do-modulo`              |\n| `modelo_voz não encontrado` | O modelo Vosk não está na pasta correta   |\n\n---\n\n## 📖 Histórico do projeto\n\nConversa completa com todas as decisões e ideias:\n\nhttps://chat.deepseek.com/share/6f64u0d6s37xcameki\n\n---\n\n## 👥 Time\n\n* Bernardo Machado Sousa — Coordenação\n* Gabriel Almeida Carvalho\n* Matheus Torquato Gomes\n\n---\n\nSalve (Ctrl+S) e depois no CMD:\n\n```bash\ngit add README.md\ngit commit -m \"README final organizado\"\ngit push\n```\n\n\n## 📝 O que falta fazer (colocar um tick no que foi feito )\n\n### 🔴 Prioridade alta\n- [X] Substituir voz robótica por **Edge TTS** (voz natural, grátis)\n- [x] Integrar **IA local com Ollama** (Phi-3 Mini) para conversas offline\n\n### 🟡 Prioridade média\n- [ ] Criar **atalho global** (Ctrl+Espaço) para abrir/fechar o Sumé\n- [ ] Fazer o Sumé **iniciar junto com o Windows**\n- [x] Implementar **VAD** (detecção de silêncio) para processar comandos automaticamente\n- [ ] Migrar memória de **JSON para SQLite** (mais robusto)\n- [ ] Adicionar **confirmação** antes de ações perigosas (ex: fechar apps)\n\n### 🟢 Futuro\n- [ ] **Leitura de tela** com OCR (\"Sumé, o que está na minha tela?\")\n- [ ] **Sistema de plugins/skills** para adicionar funções sem mexer no core\n- [ ] **Automação de navegador** (Playwright) para pesquisar e interagir com sites\n- [ ] **Dashboard completo** com chat, tarefas, calendário e status do PC\n- [ ] **Integração com Alexa** (Wake-on-LAN para ligar o PC)\n- [ ] **Visão computacional** com câmera\n- [ ] **Integração com Spotify, WhatsApp, Gmail**\n\n### 💡 Ideias\n- [ ] Modo mãos-livres total (palavra de ativação \"Sumé\")\n- [ ] Múltiplos idiomas (inglês, espanhol)\n- [ ] Agentes especializados (programador, pesquisador, estudos)\n- [ ] Interface com temas customizáveis\n- [ ] Histórico de conversas com busca"}, "82cab65d33502650644d13054be1bda82e00608a": {"t": 1785771808.7124627, "n": 5077, "h": "186b1c085caaf087", "c": "# ⚡ Sumé — Assistente Virtual\n\nAssistente pessoal com voz, memória e automações.\n\n---\n\n## 1. O que instalar\n\n| Ferramenta | Link                              | Observação                             |\n| ---------- | --------------------------------- | -------------------------------------- |\n| Python     | https://python.org                | **Marcar \"Add to PATH\"** na instalação |\n| Git        | https://git-scm.com/downloads/win | Instalação padrão (Next, Next, Finish) |\n| VS Code    | https://code.visualstudio.com     | Editor de código                       |\n\n### Conferir se instalou certo\n\nAbra o **CMD** (Windows + R, digite `cmd`, Enter) e execute:\n\n```bash\npython --version\n```\n\nDeve mostrar `Python 3.10.x` ou superior.\n\n```bash\ngit --version\n```\n\nDeve mostrar `git version 2.x.x`.\n\n```bash\ncode --version\n```\n\nDeve mostrar a versão do VS Code.\n\n---\n\n## 2. Baixar o projeto\n\n```bash\ngit clone https://github.com/BernardoMachadoSousa/sume.git\ncd sume\n```\n\n---\n\n## 3. Criar ambiente virtual e instalar dependências\n\n```bash\npython -m venv venv\nvenv\\Scripts\\activate\npip install -r requirements.txt\n```\n\n---\n\n## 4. Baixar modelo de voz (Vosk)\n\n* Link direto: https://alphacephei.com/vosk/models/vosk-model-small-pt-0.3.zip\n* Site com todos os modelos: https://alphacephei.com/vosk/models\n\nPassos:\n\n1. Extraia o `.zip` para dentro da pasta `sume`\n2. Renomeie a pasta extraída para `modelo_voz`\n\nDeve ficar assim: `C:\\Users\\seu-usuario\\sume\\modelo_voz\\`\n\n---\n\n## 5. Criar arquivo de configuração\n\n```bash\nmkdir dados\necho {\"gemini_api_key\": \"\"} > dados\\configuracoes.json\n```\n\n---\n\n## 6. Rodar o projeto\n\n```bash\npython main.py\n```\n\nSe tudo deu certo, a janela do Sumé vai abrir.\n\n---\n\n## 📁 Estrutura de pastas\n\n```\nsume/\n├── main.py                 # Inicia o app\n├── requirements.txt        # Bibliotecas necessárias\n├── core/\n│   └── nexus_core.py       # Interpreta comandos\n├── modulos/\n│   ├── memoria.py          # Memória\n│   ├── automacoes.py       # Abrir/fechar apps e sites\n│   └── ia_conversacional.py # IA\n├── utils/\n│   ├── voz.py              # Fala\n│   └── escuta.py           # Escuta\n├── interface/\n│   ├── index.html          # Tela\n│   └── assets/\n│       ├── style.css       # Visual\n│       └── script.js       # Comportamento\n└── dados/\n    └── configuracoes.json  # Chaves\n```\n\n---\n\n## 🔄 Como usar o Git\n\n### Configurar (só na primeira vez)\n\n```bash\ngit config --global user.email \"seu-email@gmail.com\"\ngit config --global user.name \"SeuNomeNoGitHub\"\n```\n\n### Antes de programar\n\n```bash\ngit pull\n```\n\n### Depois de fazer alterações\n\n```bash\ngit add .\ngit commit -m \"O que você fez\"\ngit push\n```\n\n---\n\n## 🤝 Regras da equipe\n\n1. **Sempre faça **``** antes de começar**\n2. Avise no WhatsApp o que vai mexer\n3. Teste antes de dar `git push`\n4. Não mexa no `main.py` ou `dados/configuracoes.json` sem avisar\n5. Commits em português, objetivos: `\"Adicionei comando de clima\"`\n\n---\n\n## ❗ Problemas comuns\n\n| Erro                        | Solução                                   |\n| --------------------------- | ----------------------------------------- |\n| `pip não é reconhecido`     | Reinstale o Python marcando \"Add to PATH\" |\n| PowerShell não ativa venv   | Use o **CMD**, não o PowerShell           |\n| `ModuleNotFoundError`       | `pip install nome-do-modulo`              |\n| `modelo_voz não encontrado` | O modelo Vosk não está na pasta correta   |\n\n---\n\n## 📖 Histórico do projeto\n\nConversa completa com todas as decisões e ideias:\n\nhttps://chat.deepseek.com/share/6f64u0d6s37xcameki\n\n---\n\n## 👥 Time\n\n* Bernardo Machado Sousa — Coordenação\n* Gabriel Almeida Carvalho\n* Matheus Torquato Gomes\n\n---\n\nSalve (Ctrl+S) e depois no CMD:\n\n```bash\ngit add README.md\ngit commit -m \"README final organizado\"\ngit push\n```\n\n\n## 📝 O que falta fazer (colocar um tick no que foi feito )\n\n### 🔴 Prioridade alta\n- [X] Substituir voz robótica por **Edge TTS** (voz natural, grátis)\n- [x] Integrar **IA local com Ollama** (Phi-3 Mini) para conversas offline\n\n### 🟡 Prioridade média\n- [ ] Criar **atalho global** (Ctrl+Espaço) para abrir/fechar o Sumé\n- [ ] Fazer o Sumé **iniciar junto com o Windows**\n- [ ] Implementar **VAD** (detecção de silêncio) para processar comandos automaticamente\n- [ ] Migrar memória de **JSON para SQLite** (mais robusto)\n- [ ] Adicionar **confirmação** antes de ações perigosas (ex: fechar apps)\n\n### 🟢 Futuro\n- [ ] **Leitura de tela** com OCR (\"Sumé, o que está na minha tela?\")\n- [ ] **Sistema de plugins/skills** para adicionar funções sem mexer no core\n- [ ] **Automação de navegador** (Playwright) para pesquisar e interagir com sites\n- [ ] **Dashboard completo** com chat, tarefas, calendário e status do PC\n- [ ] **Integração com Alexa** (Wake-on-LAN para ligar o PC)\n- [ ] **Visão computacional** com câmera\n- [ ] **Integração com Spotify, WhatsApp, Gmail**\n\n### 💡 Ideias\n- [ ] Modo mãos-livres total (palavra de ativação \"Sumé\")\n- [ ] Múltiplos idiomas (inglês, espanhol)\n- [ ] Agentes especializados (programador, pesquisador, estudos)\n- [ ] Interface com temas customizáveis\n- [ ] Histórico de conversas com busca"}, "7d61ceb7804001d32226b25b6f9fca82f83bde75": {"t": 1785771809.8814378, "n": 5077, "h": "1302731d6a41a5b9", "c": "# ⚡ Sumé — Assistente Virtual\n\nAssistente pessoal com voz, memória e automações.\n\n---\n\n## 1. O que instalar\n\n| Ferramenta | Link                              | Observação                             |\n| ---------- | --------------------------------- | -------------------------------------- |\n| Python     | https://python.org                | **Marcar \"Add to PATH\"** na instalação |\n| Git        | https://git-scm.com/downloads/win | Instalação padrão (Next, Next, Finish) |\n| VS Code    | https://code.visualstudio.com     | Editor de código                       |\n\n### Conferir se instalou certo\n\nAbra o **CMD** (Windows + R, digite `cmd`, Enter) e execute:\n\n```bash\npython --version\n```\n\nDeve mostrar `Python 3.10.x` ou superior.\n\n```bash\ngit --version\n```\n\nDeve mostrar `git version 2.x.x`.\n\n```bash\ncode --version\n```\n\nDeve mostrar a versão do VS Code.\n\n---\n\n## 2. Baixar o projeto\n\n```bash\ngit clone https://github.com/BernardoMachadoSousa/sume.git\ncd sume\n```\n\n---\n\n## 3. Criar ambiente virtual e instalar dependências\n\n```bash\npython -m venv venv\nvenv\\Scripts\\activate\npip install -r requirements.txt\n```\n\n---\n\n## 4. Baixar modelo de voz (Vosk)\n\n* Link direto: https://alphacephei.com/vosk/models/vosk-model-small-pt-0.3.zip\n* Site com todos os modelos: https://alphacephei.com/vosk/models\n\nPassos:\n\n1. Extraia o `.zip` para dentro da pasta `sume`\n2. Renomeie a pasta extraída para `modelo_voz`\n\nDeve ficar assim: `C:\\Users\\seu-usuario\\sume\\modelo_voz\\`\n\n---\n\n## 5. Criar arquivo de configuração\n\n```bash\nmkdir dados\necho {\"gemini_api_key\": \"\"} > dados\\configuracoes.json\n```\n\n---\n\n## 6. Rodar o projeto\n\n```bash\npython main.py\n```\n\nSe tudo deu certo, a janela do Sumé vai abrir.\n\n---\n\n## 📁 Estrutura de pastas\n\n```\nsume/\n├── main.py                 # Inicia o app\n├── requirements.txt        # Bibliotecas necessárias\n├── core/\n│   └── nexus_core.py       # Interpreta comandos\n├── modulos/\n│   ├── memoria.py          # Memória\n│   ├── automacoes.py       # Abrir/fechar apps e sites\n│   └── ia_conversacional.py # IA\n├── utils/\n│   ├── voz.py              # Fala\n│   └── escuta.py           # Escuta\n├── interface/\n│   ├── index.html          # Tela\n│   └── assets/\n│       ├── style.css       # Visual\n│       └── script.js       # Comportamento\n└── dados/\n    └── configuracoes.json  # Chaves\n```\n\n---\n\n## 🔄 Como usar o Git\n\n### Configurar (só na primeira vez)\n\n```bash\ngit config --global user.email \"seu-email@gmail.com\"\ngit config --global user.name \"SeuNomeNoGitHub\"\n```\n\n### Antes de programar\n\n```bash\ngit pull\n```\n\n### Depois de fazer alterações\n\n```bash\ngit add .\ngit commit -m \"O que você fez\"\ngit push\n```\n\n---\n\n## 🤝 Regras da equipe\n\n1. **Sempre faça **``** antes de começar**\n2. Avise no WhatsApp o que vai mexer\n3. Teste antes de dar `git push`\n4. Não mexa no `main.py` ou `dados/configuracoes.json` sem avisar\n5. Commits em português, objetivos: `\"Adicionei comando de clima\"`\n\n---\n\n## ❗ Problemas comuns\n\n| Erro                        | Solução                                   |\n| --------------------------- | ----------------------------------------- |\n| `pip não é reconhecido`     | Reinstale o Python marcando \"Add to PATH\" |\n| PowerShell não ativa venv   | Use o **CMD**, não o PowerShell           |\n| `ModuleNotFoundError`       | `pip install nome-do-modulo`              |\n| `modelo_voz não encontrado` | O modelo Vosk não está na pasta correta   |\n\n---\n\n## 📖 Histórico do projeto\n\nConversa completa com todas as decisões e ideias:\n\nhttps://chat.deepseek.com/share/6f64u0d6s37xcameki\n\n---\n\n## 👥 Time\n\n* Bernardo Machado Sousa — Coordenação\n* Gabriel Almeida Carvalho\n* Matheus Torquato Gomes\n\n---\n\nSalve (Ctrl+S) e depois no CMD:\n\n```bash\ngit add README.md\ngit commit -m \"README final organizado\"\ngit push\n```\n\n\n## 📝 O que falta fazer (colocar um tick no que foi feito )\n\n### 🔴 Prioridade alta\n- [ ] Substituir voz robótica por **Edge TTS** (voz natural, grátis)\n- [ ] Integrar **IA local com Ollama** (Phi-3 Mini) para conversas offline\n\n### 🟡 Prioridade média\n- [ ] Criar **atalho global** (Ctrl+Espaço) para abrir/fechar o Sumé\n- [ ] Fazer o Sumé **iniciar junto com o Windows**\n- [ ] Implementar **VAD** (detecção de silêncio) para processar comandos automaticamente\n- [ ] Migrar memória de **JSON para SQLite** (mais robusto)\n- [ ] Adicionar **confirmação** antes de ações perigosas (ex: fechar apps)\n\n### 🟢 Futuro\n- [ ] **Leitura de tela** com OCR (\"Sumé, o que está na minha tela?\")\n- [ ] **Sistema de plugins/skills** para adicionar funções sem mexer no core\n- [ ] **Automação de navegador** (Playwright) para pesquisar e interagir com sites\n- [ ] **Dashboard completo** com chat, tarefas, calendário e status do PC\n- [ ] **Integração com Alexa** (Wake-on-LAN para ligar o PC)\n- [ ] **Visão computacional** com câmera\n- [ ] **Integração com Spotify, WhatsApp, Gmail**\n\n### 💡 Ideias\n- [ ] Modo mãos-livres total (palavra de ativação \"Sumé\")\n- [ ] Múltiplos idiomas (inglês, espanhol)\n- [ ] Agentes especializados (programador, pesquisador, estudos)\n- [ ] Interface com temas customizáveis\n- [ ] Histórico de conversas com busca"}, "fe429ffda627b1fcaa5a9f949a198325e4b5ee9e": {"t": 1785771811.7786992, "n": 3753, "h": "86fa255469632d7a", "c": "# ⚡ Sumé — Assistente Virtual\n\nAssistente pessoal com voz, memória e automações.\n\n---\n\n## 1. O que instalar\n\n| Ferramenta | Link                              | Observação                             |\n| ---------- | --------------------------------- | -------------------------------------- |\n| Python     | https://python.org                | **Marcar \"Add to PATH\"** na instalação |\n| Git        | https://git-scm.com/downloads/win | Instalação padrão (Next, Next, Finish) |\n| VS Code    | https://code.visualstudio.com     | Editor de código                       |\n\n### Conferir se instalou certo\n\nAbra o **CMD** (Windows + R, digite `cmd`, Enter) e execute:\n\n```bash\npython --version\n```\n\nDeve mostrar `Python 3.10.x` ou superior.\n\n```bash\ngit --version\n```\n\nDeve mostrar `git version 2.x.x`.\n\n```bash\ncode --version\n```\n\nDeve mostrar a versão do VS Code.\n\n---\n\n## 2. Baixar o projeto\n\n```bash\ngit clone https://github.com/BernardoMachadoSousa/sume.git\ncd sume\n```\n\n---\n\n## 3. Criar ambiente virtual e instalar dependências\n\n```bash\npython -m venv venv\nvenv\\Scripts\\activate\npip install -r requirements.txt\n```\n\n---\n\n## 4. Baixar modelo de voz (Vosk)\n\n* Link direto: https://alphacephei.com/vosk/models/vosk-model-small-pt-0.3.zip\n* Site com todos os modelos: https://alphacephei.com/vosk/models\n\nPassos:\n\n1. Extraia o `.zip` para dentro da pasta `sume`\n2. Renomeie a pasta extraída para `modelo_voz`\n\nDeve ficar assim: `C:\\Users\\seu-usuario\\sume\\modelo_voz\\`\n\n---\n\n## 5. Criar arquivo de configuração\n\n```bash\nmkdir dados\necho {\"gemini_api_key\": \"\"} > dados\\configuracoes.json\n```\n\n---\n\n## 6. Rodar o projeto\n\n```bash\npython main.py\n```\n\nSe tudo deu certo, a janela do Sumé vai abrir.\n\n---\n\n## 📁 Estrutura de pastas\n\n```\nsume/\n├── main.py                 # Inicia o app\n├── requirements.txt        # Bibliotecas necessárias\n├── core/\n│   └── nexus_core.py       # Interpreta comandos\n├── modulos/\n│   ├── memoria.py          # Memória\n│   ├── automacoes.py       # Abrir/fechar apps e sites\n│   └── ia_conversacional.py # IA\n├── utils/\n│   ├── voz.py              # Fala\n│   └── escuta.py           # Escuta\n├── interface/\n│   ├── index.html          # Tela\n│   └── assets/\n│       ├── style.css       # Visual\n│       └── script.js       # Comportamento\n└── dados/\n    └── configuracoes.json  # Chaves\n```\n\n---\n\n## 🔄 Como usar o Git\n\n### Configurar (só na primeira vez)\n\n```bash\ngit config --global user.email \"seu-email@gmail.com\"\ngit config --global user.name \"SeuNomeNoGitHub\"\n```\n\n### Antes de programar\n\n```bash\ngit pull\n```\n\n### Depois de fazer alterações\n\n```bash\ngit add .\ngit commit -m \"O que você fez\"\ngit push\n```\n\n---\n\n## 🤝 Regras da equipe\n\n1. **Sempre faça **``** antes de começar**\n2. Avise no WhatsApp o que vai mexer\n3. Teste antes de dar `git push`\n4. Não mexa no `main.py` ou `dados/configuracoes.json` sem avisar\n5. Commits em português, objetivos: `\"Adicionei comando de clima\"`\n\n---\n\n## ❗ Problemas comuns\n\n| Erro                        | Solução                                   |\n| --------------------------- | ----------------------------------------- |\n| `pip não é reconhecido`     | Reinstale o Python marcando \"Add to PATH\" |\n| PowerShell não ativa venv   | Use o **CMD**, não o PowerShell           |\n| `ModuleNotFoundError`       | `pip install nome-do-modulo`              |\n| `modelo_voz não encontrado` | O modelo Vosk não está na pasta correta   |\n\n---\n\n## 📖 Histórico do projeto\n\nConversa completa com todas as decisões e ideias:\n\nhttps://chat.deepseek.com/share/6f64u0d6s37xcameki\n\n---\n\n## 👥 Time\n\n* Bernardo Machado Sousa — Coordenação\n* Gabriel Almeida Carvalho\n* Matheus Torquato Gomes\n\n---\n\nSalve (Ctrl+S) e depois no CMD:\n\n```bash\ngit add README.md\ngit commit -m \"README final organizado\"\ngit push\n```\n"}, "e5b463c5d037f02e25df4936e96e947e2bd2f453": {"t": 1785771812.9996786, "n": 3239, "h": "0c5465ef1a396a0a", "c": "# ⚡ Sumé — Guia para Desenvolvedores\n\nEste documento é para os integrantes da equipe. Siga as instruções abaixo antes de começar a programar.\n\n---\n\n# 🚀 Primeira configuração\n\n## 1. Instalar ferramentas\n\n### Python\n\nhttps://python.org\n\n⚠️ Durante a instalação marque:\n\n```text\nAdd Python to PATH\n```\n\n### Git\n\nhttps://git-scm.com/downloads/win\n\n### VS Code\n\nhttps://code.visualstudio.com\n\n---\n\n## 2. Baixar o projeto\n\nAbra o CMD e execute:\n\n```bash\ngit clone https://github.com/BernardoMachadoSousa/sume.git\ncd sume\n```\n\n---\n\n## 3. Criar ambiente virtual\n\n```bash\npython -m venv venv\nvenv\\Scripts\\activate\n```\n\n---\n\n## 4. Instalar dependências\n\n```bash\npip install -r requirements.txt\n```\n\n---\n\n## 5. Baixar o modelo de voz\n\nAcesse:\n\nhttps://alphacephei.com/vosk/models\n\nBaixe:\n\n```text\nvosk-model-small-pt-0.3.zip\n```\n\nExtraia para dentro da pasta do projeto.\n\nRenomeie a pasta para:\n\n```text\nmodelo_voz\n```\n\n---\n\n## 6. Criar arquivo de configuração\n\n```bash\nmkdir dados\necho {\"gemini_api_key\": \"\"} > dados\\configuracoes.json\n```\n\n---\n\n## 7. Rodar o projeto\n\n```bash\npython main.py\n```\n\n---\n\n# 📁 Onde alterar cada coisa\n\n```text\nmain.py\n```\n\nInicialização do sistema.\n\n---\n\n```text\ncore/nexus_core.py\n```\n\nInterpretação dos comandos.\n\n---\n\n```text\nmodulos/memoria.py\n```\n\nSistema de memória.\n\n---\n\n```text\nmodulos/automacoes.py\n```\n\nAbrir e fechar programas, sites e automações.\n\n---\n\n```text\nmodulos/ia_conversacional.py\n```\n\nIntegração com IA.\n\n---\n\n```text\nutils/voz.py\n```\n\nSistema de fala.\n\n---\n\n```text\nutils/escuta.py\n```\n\nReconhecimento de voz.\n\n---\n\n```text\ninterface/index.html\n```\n\nEstrutura da interface.\n\n---\n\n```text\ninterface/assets/style.css\n```\n\nVisual da interface.\n\n---\n\n```text\ninterface/assets/script.js\n```\n\nComportamento da interface.\n\n---\n\n# 🔄 Fluxo obrigatório antes de programar\n\nSempre execute:\n\n```bash\ngit pull\n```\n\nIsso garante que você está com a versão mais recente.\n\n---\n\n# ✅ Depois de fazer alterações\n\nTeste tudo antes.\n\nSe estiver funcionando:\n\n```bash\ngit add .\ngit commit -m \"Descrição da alteração\"\ngit push\n```\n\nExemplo:\n\n```bash\ngit commit -m \"Adicionado comando para abrir calculadora\"\n```\n\n---\n\n# ⚠️ Antes de alterar qualquer coisa\n\nAvise no grupo:\n\n```text\nVou trabalhar no módulo de memória.\n```\n\nou\n\n```text\nVou alterar a interface.\n```\n\nAssim evitamos conflitos.\n\n---\n\n# 🚫 Não alterar sem avisar\n\nArquivos críticos:\n\n```text\nmain.py\ndados/configuracoes.json\ncore/nexus_core.py\n```\n\nSe precisar alterar, avise no grupo antes.\n\n---\n\n# 🤝 Regras da equipe\n\n1. Sempre fazer git pull antes de começar.\n2. Avisar no grupo o módulo que será alterado.\n3. Testar antes de fazer push.\n4. Não enviar código quebrado.\n5. Commits em português e objetivos.\n6. Fazer uma alteração por vez.\n7. Em caso de dúvida, perguntar antes de modificar.\n\n---\n\n# ❗ Problemas comuns\n\n### pip não é reconhecido\n\nReinstale o Python marcando:\n\n```text\nAdd Python to PATH\n```\n\n---\n\n### Não consegue ativar a venv\n\nUse CMD.\n\nNão use PowerShell.\n\n---\n\n### ModuleNotFoundError\n\nInstale o módulo faltante:\n\n```bash\npip install nome-do-modulo\n```\n\n---\n\n### modelo_voz não encontrado\n\nVerifique se existe:\n\n```text\nsume/modelo_voz/\n```\n\n---\n\n# 👥 Equipe\n\n* Bernardo Machado Sousa \n* Gabriel Almeida Carvalho\n* Matheus Torquato Gomes\n"}}}}