🧠 BrainDesk - Assistente Inteligente de Estudos

O BrainDesk é um assistente de estudos com IA que permite salvar conteúdos, gerar resumos, questões e flashcards automaticamente, além de possuir sistema de atualização automática via GitHub.

---

🚀 Como rodar o projeto na sua máquina

🔧 1. Pré-requisitos

Antes de tudo, você precisa ter instalado:

• Python 3.10 ou superior
• Git
• Ollama instalado e rodando

---

📥 2. Clonar o repositório

Abra o terminal e execute:

git clone https://github.com/SEU-USUARIO/BrainDesk.git
cd BrainDesk

---

📦 3. Instalar dependências

pip install -r requirements.txt

Caso não tenha o arquivo requirements.txt, instale manualmente:

pip install customtkinter ollama chromadb sentence-transformers requests

---

🤖 4. Instalar e rodar o modelo (Ollama)

Instale o modelo utilizado:

ollama pull llama3

Depois, deixe o Ollama rodando:

ollama run llama3

---

▶️ 5. Executar o projeto

python app.py

---

🧠 Como usar

• Digite textos para salvar como estudo

• Faça perguntas para a IA

• Use os botões laterais para:

  • 📌 Gerar resumo
  • ❓ Gerar questões
  • 🧠 Gerar flashcards
  • 📜 Ver histórico
  • 🧹 Limpar memória

---

🔄 Atualizações automáticas

O BrainDesk verifica automaticamente se há novas versões no GitHub.

Se houver:

• baixa a atualização
• instala automaticamente
• reinicia o app

---

📦 Rodar versão executável (.exe)

Se preferir, você pode rodar sem Python:

1. Vá até Releases no GitHub
2. Baixe o arquivo .zip mais recente
3. Extraia os arquivos
4. Execute:

BrainDesk.exe

---

🛠️ Gerar o .exe manualmente

Se quiser gerar o executável:

pyinstaller --onedir --windowed app.py

O arquivo será gerado em:

dist/app/

---

⚠️ Possíveis problemas

❌ IA não responde

• Verifique se o Ollama está rodando

❌ Erro de dependência

• Rode novamente o pip install

❌ Update não funciona

• Verifique se existe uma Release no GitHub

---

📁 Estrutura do projeto

BrainDesk/
 ├── app.py
 ├── database.py
 ├── updater.py
 ├── meu_banco/

---

👨‍💻 Autor

Desenvolvido por você 🚀

---

⭐ Contribuição

Sinta-se livre para:

• abrir issues
• sugerir melhorias
• contribuir com código

---

📌 Licença

Este projeto é livre para uso educacional.