README.md

metadata

title: English Helper
emoji: 🎓
colorFrom: blue
colorTo: purple
sdk: gradio
app_file: app.py
pinned: false
license: mit

English Helper - HF Spaces

Sistema simplificado de aprendizado de inglês para Hugging Face Spaces.

🚀 Funcionalidades

• Seleção de Usuário: Escolha ou crie usuário (sem autenticação)
• Text-to-Speech: Áudio dos textos com gTTS
• Flashcards: Criação automática com IA
• Chat: Conversação básica
• Admin Panel: Gestão de usuários em /admin
• Status Page: Monitoramento em /status

🏗️ Arquitetura Simplificada

• Storage: Arquivos JSON em hf_data/
• No Database: Sistema baseado em arquivos
• No Authentication: Seleção de usuário apenas
• Minimal Dependencies: Flask + requests + gTTS

📁 Estrutura

app.py              # Entry point HF
flask_app_hf.py     # Flask simplificado
requirements.txt    # Dependências mínimas
templates/          # Interface HTML
├── index.html     # Interface principal
├── admin.html     # Painel admin
└── status.html    # Status do sistema

🎯 Deploy

1. Faça upload de todos os arquivos desta pasta para seu HF Space
2. O app roda automaticamente na porta 7860
3. Acesse a interface principal, admin (/admin) e status (/status)

---

Versão simplificada para máxima compatibilidade com HF Spaces