# 🚀 Guia de Início Rápido - ImgBoost

## Instalação em 3 passos

### 1. Clone o repositório
```bash
git clone https://github.com/yourusername/imgboost.git
cd imgboost
```

### 2. Instale as dependências
```bash
pip install -r requirements.txt
```

### 3. Instale o ImgBoost
```bash
pip install -e .
```

## Teste se funcionou

```bash
imgboost info
```

Deve mostrar as informações da biblioteca e dependências instaladas.

## Primeiros comandos

### 1. Melhorar uma foto qualquer
```bash
imgboost process minha_foto.jpg
```
✅ Resultado salvo em: `output/minha_foto_general.jpg`

### 2. Melhorar print de WhatsApp escuro
```bash
imgboost process screenshot.png --mode dark
```
✅ Resultado salvo em: `output/screenshot_dark.png`

### 3. Preparar documento para OCR
```bash
imgboost process documento.jpg --mode text
```
✅ Resultado salvo em: `output/documento_text.jpg`

### 4. Aumentar resolução 2x
```bash
imgboost process imagem_pequena.png --upscale
```
✅ Resultado salvo em: `output/imagem_pequena_general_2x.png`

### 5. Processar pasta inteira
```bash
imgboost process ./minhas_fotos --output ./melhoradas
```
✅ Todas as fotos processadas em: `melhoradas/`

## Modos disponíveis

| Modo | Descrição | Quando usar |
|------|-----------|-------------|
| `general` | Melhoria geral balanceada | Fotos, prints, screenshots |
| `text` | Otimizado para texto/OCR | Documentos, notas, papel |
| `dark` | Otimizado para UIs escuras | WhatsApp Dark, apps noturnos |
| `superres` | Super-resolução + melhoria | Imagens de baixa resolução |

## Opções mais usadas

```bash
# Qualidade máxima em PNG
imgboost process foto.jpg --quality 100 --format png

# Denoise forte para foto antiga
imgboost process foto_antiga.jpg --denoise-strength 20

# Contraste agressivo
imgboost process foto_escura.jpg --contrast 5.0

# Sharpen extra
imgboost process foto.jpg --sharpen

# Modo verboso (ver o que está acontecendo)
imgboost process foto.jpg --verbose
```

## Atalhos úteis

```bash
# Abreviar opções
imgboost process foto.jpg -m text -o saida -u -v

# Combinar múltiplas opções
imgboost process doc.jpg -m text -f png -q 100 -d 15 -s
```

## Problemas comuns

### ❌ "comando não encontrado: imgboost"
**Solução:** Execute `pip install -e .` novamente dentro da pasta imgboost

### ❌ "Erro ao carregar imagem"
**Solução:** Verifique se o arquivo existe e se é uma imagem válida (jpg, png, etc)

### ❌ Resultado não ficou bom
**Solução:** Tente outros modos ou ajuste os parâmetros:
- Aumente denoise: `--denoise-strength 20`
- Aumente contraste: `--contrast 4.0`
- Adicione sharpen: `--sharpen`
- Use upscale: `--upscale`

## Próximos passos

📖 Leia o [README.md](README.md) completo para opções avançadas

🧪 Execute `python examples.py` para ver exemplos de código

💡 Use `imgboost process --help` para ver todas as opções

🐛 Encontrou um bug? Abra uma issue no GitHub!

---

**Dica:** Teste com diferentes modos e compare os resultados para entender qual funciona melhor para cada tipo de imagem!
