README.md

---
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**