Spaces:
Sleeping
Sleeping
Update README with project overview, features, and setup instructions
Browse files
README.md
CHANGED
|
@@ -1,2 +1,53 @@
|
|
| 1 |
-
#
|
| 2 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# 📚 BookMatch AI
|
| 2 |
+
|
| 3 |
+
Uma aplicação web de recomendação de livros com IA, desenvolvida com Python e Flask, integrada ao modelo Gemini da Google.
|
| 4 |
+
|
| 5 |
+
Usuários criam um perfil com seus gêneros favoritos, tiram dúvidas e se informam sobre qualquer assunto no universo literário e recebem sugestões personalizadas de leitura. Tudo isso via chat com IA.
|
| 6 |
+
|
| 7 |
+
👉 [Teste agora no Hugging Face Spaces](https://huggingface.co/spaces/vioott/BookMatchAI-Python-GeminiAPI)
|
| 8 |
+
|
| 9 |
+
## 🔧 Tecnologias utilizadas
|
| 10 |
+
|
| 11 |
+
- 🐍 Python + Flask (back-end web)
|
| 12 |
+
- 🌐 HTML + CSS (front-end responsivo)
|
| 13 |
+
- 🤖 Google Gemini 1.5 Flash (modelo de IA)
|
| 14 |
+
- 🧠 Sistema de logging para histórico de interações
|
| 15 |
+
|
| 16 |
+
## ✨ Funcionalidades
|
| 17 |
+
|
| 18 |
+
- Criação e edição de perfis de usuário com preferências literárias
|
| 19 |
+
- Interface web responsiva para chat com IA
|
| 20 |
+
- Respostas personalizadas com base nas preferências salvas
|
| 21 |
+
- Log de interações com histórico e recomendações da IA
|
| 22 |
+
|
| 23 |
+
## 🚀 Como executar localmente
|
| 24 |
+
|
| 25 |
+
1. Clone o repositório:
|
| 26 |
+
```
|
| 27 |
+
git clone https://github.com/seu-usuario/bookmatch-ai-python-geminiAPI.git
|
| 28 |
+
cd bookmatch-ai-python-geminiAPI
|
| 29 |
+
python -m venv venv
|
| 30 |
+
source venv/bin/activate
|
| 31 |
+
# No Windows use: venv\Scripts\activate
|
| 32 |
+
pip install -r requirements.txt
|
| 33 |
+
````
|
| 34 |
+
|
| 35 |
+
2. Crie um arquivo `.env` com sua chave da API Gemini:
|
| 36 |
+
|
| 37 |
+
```
|
| 38 |
+
GOOGLE_API_KEY=sua-chave-aqui
|
| 39 |
+
```
|
| 40 |
+
|
| 41 |
+
3. Execute o app:
|
| 42 |
+
|
| 43 |
+
```
|
| 44 |
+
python app.py
|
| 45 |
+
```
|
| 46 |
+
|
| 47 |
+
## 🧠 Sobre o projeto
|
| 48 |
+
|
| 49 |
+
Este projeto foi criado como solução para o exercício "Implementando um 'If Mágico' em uma Aplicação de E-commerce", do curso "IA para Programação com Python", da [Trybe](https://www.betrybe.com/), para explorar aplicações de IA generativa na recomendação literária, com foco em UX, personalização e uso real de modelos LLM.
|
| 50 |
+
|
| 51 |
+
---
|
| 52 |
+
|
| 53 |
+
Desenvolvido por Vania Ioott – Full-Stack Developer & AI Enthusiast.
|