imgboost-ai 0.1.0__tar.gz

imgboost_ai-0.1.0/.gitignore

@@ -0,0 +1,74 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual Environment
+venv/
+ENV/
+env/
+.venv
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+*.cover
+.hypothesis/
+
+# Output and temporary files
+output/
+*.log
+temp/
+tmp/
+
+# Jupyter Notebooks
+.ipynb_checkpoints
+
+# Distribution / packaging
+*.whl
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre
+.pyre/
+
+# Backup files
+*.bak
+*.backup
+*~
+
+# OS files
+Thumbs.db
+.DS_Store

imgboost_ai-0.1.0/CHANGELOG.md

@@ -0,0 +1,100 @@
+# Changelog
+
+Todas as mudanças notáveis neste projeto serão documentadas neste arquivo.
+
+O formato é baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.0.0/),
+e este projeto adere ao [Semantic Versioning](https://semver.org/lang/pt-BR/).
+
+## [0.1.0] - 2026-02-06
+
+### Adicionado
+- ✨ Interface CLI completa usando Click
+- 🎯 4 modos de processamento especializados:
+  - `general`: Melhoria geral balanceada
+  - `text`: Otimizado para documentos e OCR
+  - `dark`: Otimizado para interfaces escuras
+  - `superres`: Super-resolução com upscaling
+- 🔧 Filtros de processamento de imagem:
+  - Denoise com Fast Non-Local Means
+  - CLAHE para contraste adaptativo
+  - Sharpening profissional
+  - Unsharp mask
+  - Ajuste de gamma
+  - Balanço de branco automático
+- 📄 Processador especializado para documentos:
+  - Binarização adaptativa
+  - Deskew (correção de inclinação)
+  - Remoção de sombras
+  - Detecção de regiões de texto
+  - Pipeline completo para OCR
+- 🚀 Super-resolução:
+  - Upscaling com LANCZOS4
+  - Multi-scale enhancement
+  - Realce de texturas
+  - Suporte para modelos de IA (futuro)
+- ⚡ Processamento em lote:
+  - Comando `batch` com paralelização
+  - Barra de progresso com tqdm
+  - Suporte a múltiplos workers
+- 💾 Suporte a múltiplos formatos:
+  - JPEG, PNG, BMP, TIFF, WebP
+  - Conversão automática entre formatos
+  - Ajuste de qualidade por formato
+- 📊 Comando `info` para verificar sistema
+- 🧪 Suite de testes completa
+- 📖 Documentação extensiva:
+  - README.md completo
+  - QUICKSTART.md para início rápido
+  - Exemplos de código
+  - Comentários inline
+- 🛠️ Scripts auxiliares:
+  - `install.sh` para instalação rápida
+  - `examples.py` com exemplos práticos
+  - `test_imgboost.py` para testes
+
+### Características técnicas
+- Arquitetura modular e extensível
+- Processadores independentes e reutilizáveis
+- Pipeline configurável por parâmetros
+- Tratamento robusto de erros
+- Logging e modo verbose
+- Validação de entrada
+- Preservação de metadados (quando possível)
+
+### Dependências
+- Python >= 3.8
+- OpenCV >= 4.8.0
+- NumPy >= 1.24.0
+- Click >= 8.1.0
+- scikit-image >= 0.21.0
+- tqdm >= 4.66.0
+- PyTorch >= 2.0.0 (opcional)
+
+## [Futuro] - Planejado
+
+### A implementar
+- [ ] Integração completa com Real-ESRGAN
+- [ ] Download automático de modelos
+- [ ] Suporte a processamento de vídeo
+- [ ] Processamento de PDFs multipáginas
+- [ ] Interface web com Flask/FastAPI
+- [ ] Presets customizáveis salvos
+- [ ] Processamento com GPU (CUDA)
+- [ ] Comparação lado a lado de resultados
+- [ ] Estatísticas de melhoria (PSNR, SSIM)
+- [ ] Plugin para Photoshop/GIMP
+- [ ] API REST para integração
+- [ ] Docker container
+- [ ] Testes unitários com pytest
+- [ ] CI/CD com GitHub Actions
+- [ ] Publicação no PyPI
+
+---
+
+**Legenda:**
+- ✨ Novo recurso
+- 🔧 Melhoria
+- 🐛 Correção de bug
+- 📖 Documentação
+- 🚀 Performance
+- ⚡ Funcionalidade

imgboost_ai-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,261 @@
+# Contribuindo para o ImgBoost 🤝
+
+Obrigado por considerar contribuir com o ImgBoost! 
+
+## Como Contribuir
+
+### 🐛 Reportar Bugs
+
+Se encontrou um bug, abra uma issue com:
+- Descrição clara do problema
+- Passos para reproduzir
+- Comportamento esperado vs atual
+- Screenshots (se aplicável)
+- Informações do sistema (`imgboost info`)
+
+### ✨ Sugerir Funcionalidades
+
+Para sugerir novas funcionalidades:
+- Abra uma issue com tag "enhancement"
+- Descreva o caso de uso
+- Explique por que seria útil
+- Dê exemplos de uso
+
+### 🔧 Pull Requests
+
+1. **Fork o projeto**
+   ```bash
+   git clone https://github.com/yourusername/imgboost.git
+   cd imgboost
+   ```
+
+2. **Crie uma branch**
+   ```bash
+   git checkout -b feature/minha-funcionalidade
+   # ou
+   git checkout -b fix/meu-bugfix
+   ```
+
+3. **Faça suas alterações**
+   - Siga o estilo de código existente
+   - Adicione testes se aplicável
+   - Atualize a documentação
+   - Adicione comentários quando necessário
+
+4. **Teste suas mudanças**
+   ```bash
+   python test_imgboost.py
+   ```
+
+5. **Commit suas mudanças**
+   ```bash
+   git add .
+   git commit -m "feat: adiciona funcionalidade X"
+   # ou
+   git commit -m "fix: corrige bug Y"
+   ```
+
+   **Padrão de commits:**
+   - `feat:` nova funcionalidade
+   - `fix:` correção de bug
+   - `docs:` documentação
+   - `style:` formatação
+   - `refactor:` refatoração
+   - `test:` testes
+   - `chore:` tarefas gerais
+
+6. **Push para o GitHub**
+   ```bash
+   git push origin feature/minha-funcionalidade
+   ```
+
+7. **Abra um Pull Request**
+   - Descreva suas mudanças
+   - Referencie issues relacionadas
+   - Aguarde review
+
+## Estrutura do Código
+
+```
+imgboost/
+├── imgboost/
+│   ├── cli.py              # Interface de linha de comando
+│   ├── core.py             # Engine principal
+│   ├── processors/         # Algoritmos de processamento
+│   │   ├── filters.py      # Filtros gerais
+│   │   ├── document.py     # Processamento de docs
+│   │   └── superres.py     # Super-resolução
+│   └── utils/
+│       └── image_io.py     # I/O de imagens
+```
+
+## Guia de Estilo
+
+### Python
+- Siga PEP 8
+- Use type hints quando possível
+- Docstrings em português
+- Máximo 100 caracteres por linha
+- 4 espaços de indentação
+
+**Exemplo:**
+```python
+def process_image(img: np.ndarray, strength: int = 10) -> np.ndarray:
+    """
+    Processa a imagem aplicando denoise.
+    
+    Args:
+        img: Imagem BGR
+        strength: Força do denoise (0-30)
+        
+    Returns:
+        Imagem processada
+    """
+    # Código aqui
+    pass
+```
+
+### Commits
+- Use mensagens descritivas
+- Primeira linha com no máximo 72 caracteres
+- Use verbos no imperativo ("adiciona", não "adicionado")
+- Referencie issues quando aplicável
+
+**Exemplos bons:**
+```
+feat: adiciona suporte a processamento de PDF
+fix: corrige erro ao carregar PNG com transparência
+docs: atualiza README com novos exemplos
+```
+
+**Exemplos ruins:**
+```
+atualização
+fix bug
+mudanças várias
+```
+
+## Adicionando Novos Processadores
+
+Para adicionar um novo processador:
+
+1. **Crie o arquivo em `imgboost/processors/`**
+   ```python
+   # novo_processador.py
+   class NovoProcessador:
+       def __init__(self):
+           pass
+       
+       def processar(self, img):
+           # Sua lógica aqui
+           return img
+   ```
+
+2. **Importe em `__init__.py`**
+   ```python
+   from .novo_processador import NovoProcessador
+   
+   __all__ = [..., 'NovoProcessador']
+   ```
+
+3. **Use no `core.py`**
+   ```python
+   from .processors import NovoProcessador
+   
+   self.novo = NovoProcessador()
+   ```
+
+4. **Adicione testes**
+   ```python
+   def test_novo_processador():
+       proc = NovoProcessador()
+       img = create_test_image()
+       result = proc.processar(img)
+       assert result is not None
+   ```
+
+5. **Documente**
+   - Atualize o README
+   - Adicione exemplo
+   - Atualize CHANGELOG
+
+## Adicionando Novos Modos
+
+Para adicionar um novo modo de processamento:
+
+1. **Adicione a opção no CLI** (`cli.py`)
+   ```python
+   @click.option('--mode', '-m', 
+                 type=click.Choice(['general', 'text', 'dark', 'novo'], ...)
+   ```
+
+2. **Implemente no Engine** (`core.py`)
+   ```python
+   def _process_novo(self, img):
+       """Pipeline do novo modo."""
+       # Sua lógica
+       return img
+   ```
+
+3. **Adicione ao switch de modos**
+   ```python
+   elif mode == 'novo':
+       img = self._process_novo(img)
+   ```
+
+## Testes
+
+Execute os testes antes de fazer PR:
+
+```bash
+# Testes básicos
+python test_imgboost.py
+
+# Teste manual
+imgboost process test_image.jpg --mode general -v
+
+# Teste de lote
+imgboost batch test_images/ --workers 4
+```
+
+## Documentação
+
+Ao adicionar funcionalidades, atualize:
+- [ ] README.md (se for feature visível)
+- [ ] QUICKSTART.md (se for uso básico)
+- [ ] Docstrings no código
+- [ ] CHANGELOG.md
+- [ ] Exemplos em `examples.py`
+
+## Checklist do PR
+
+Antes de submeter seu PR, verifique:
+
+- [ ] Código segue o guia de estilo
+- [ ] Testes passam
+- [ ] Documentação atualizada
+- [ ] CHANGELOG atualizado
+- [ ] Commit messages descritivos
+- [ ] Sem arquivos desnecessários
+- [ ] Branch está atualizada com main
+
+## Dúvidas?
+
+- 💬 Abra uma issue para discussão
+- 📧 Entre em contato via email (se disponível)
+- 🐛 Reporte bugs através de issues
+
+## Código de Conduta
+
+- Seja respeitoso e profissional
+- Aceite críticas construtivas
+- Foque no que é melhor para o projeto
+- Mostre empatia com outros contribuidores
+
+## Licença
+
+Ao contribuir, você concorda que suas contribuições serão licenciadas sob a licença MIT.
+
+---
+
+**Obrigado por contribuir! 🎉**

imgboost_ai-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ImgBoost Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

imgboost_ai-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+include requirements.txt
+recursive-include imgboost *.py