Update README with setup instructions

README.md

@@ -1,16 +1,50 @@
-# ML Intern - Docker Space
+# 🧠 ML Intern - Docker Space
 
-Agente autônomo de ML com interface web e CLI.
+Agente autônomo de ML com interface web e CLI, rodando em um Space Docker no HuggingFace.
 
-## Variáveis de Ambiente (Secrets)
+## 🔗 URL do Space
 
-Configure na aba **Settings > Secrets** do Space:
+https://huggingface.co/spaces/Erinaldordso/ml-intern-docker
 
-- `HF_TOKEN` - Token do HuggingFace (obrigatório)
-- `ANTHROPIC_API_KEY` - Para usar Claude (opcional)
-- `OPENAI_API_KEY` - Para usar GPT (opcional)
-- `GITHUB_TOKEN` - Para acesso ao GitHub (opcional)
+## ⚙️ Configuração (OBRIGATÓRIA)
 
-## Uso
+Vá em **Settings > Secrets** no Space e configure:
 
-Acesse a URL do Space para usar a interface web.
+| Secret | Obrigatório | Descrição |
+|--------|-------------|-----------|
+| `HF_TOKEN` | ✅ Sim | Token do HuggingFace (obter em https://huggingface.co/settings/tokens) |
+| `ANTHROPIC_API_KEY` | ❌ Não | Para usar Claude (pago) |
+| `OPENAI_API_KEY` | ❌ Não | Para usar GPT (pago) |
+| `GITHUB_TOKEN` | ❌ Não | Para acesso a repositórios GitHub |
+
+## 🚀 Como Usar
+
+1. Aguarde o Space terminar de buildar (pode levar 5-10 minutos)
+2. Acesse a URL do Space
+3. Faça login com sua conta HuggingFace
+4. Comece a interagir com o agente!
+
+## 🆓 Modelos Gratuitos (sem API key paga)
+
+Se você não tem ANTHROPIC_API_KEY ou OPENAI_API_KEY, o agente pode usar modelos gratuitos via HF Router:
+- `MiniMaxAI/MiniMax-M2.7`
+- `moonshotai/Kimi-K2.6`
+- `zai-org/GLM-5.1`
+
+Use o comando `/model` no chat para trocar de modelo.
+
+## 📚 Documentação
+
+Este Space é baseado no [ML Intern oficial](https://github.com/huggingface/ml-intern).
+
+## 🐳 Docker Local (opcional)
+
+Se preferir rodar localmente:
+
+```bash
+docker run -it --rm \
+  -e HF_TOKEN=seu_token \
+  -e ANTHROPIC_API_KEY=sua_chave \
+  -p 7860:7860 \
+  huggingface/space-ml-intern
+```