Herramienta de código abierto gratuita convierte fotos en arte de píxel en minutos

Si amas el aspecto nostálgico de los gráficos de 8‑bit pero no quieres aprender a pintar píxeles a mano, Photo2Pixel es la respuesta. Es un repositorio Python que utiliza PyTorch para convertir automáticamente cualquier fotografía en una imagen de estilo pixel‑art. El algoritmo aplica una matriz de desenfoque para transiciones de color suaves, cuantifica la imagen en bloques de píxeles de tamaño fijo y añade líneas de borde negras opcionales para dar ese clásico toque retro.

¿Qué es Photo2Pixel?

Photo2Pixel es más que un simple guion; es un pequeño ecosistema:

• Demo en línea – Visita photo2pixel.co para ver el conversor en acción en el navegador.
• Cuaderno de Colab – El repositorio incluye un cuaderno listo para ejecutar que te permite experimentar sin instalar nada localmente.
• Herramienta CLI – Una interfaz de línea de comandos ligera (convert.py) que acepta una ruta de imagen y algunos parámetros ajustables.

El proyecto se publica bajo la licencia Apache‑2.0, tiene más de 500 estrellas en GitHub y se mantiene activamente.

Características clave

Instalación y configuración

# Clonar el repositorio
git clone https://github.com/Jzou44/photo2pixel.git
cd photo2pixel

# Crear un entorno virtual (opcional pero recomendado)
python -m venv venv
source venv/bin/activate  # En Windows: venv\Scripts\activate

# Instalar dependencias
pip install -r requirements.txt

Si solo quieres ejecutar el conversor en línea, puedes omitir la instalación local y usar la interfaz web en photo2pixel.co.

Uso básico

python convert.py --input ./images/example_input_mountain.jpg

De forma predeterminada, la salida se escribe en ./result.png. El comando usará:

• kernel_size=10
• pixel_size=16
• edge_thresh=100

Estos valores predeterminados funcionan bien para la mayoría de las imágenes.

Personalizando la salida

Ajusta los tres parámetros para adaptarlos a tu estilo:

python convert.py \
  --input ./images/hero.png \
  --kernel_size 12 \
  --pixel_size 12 \
  --edge_thresh 80 \
  --output ./output/hero_pixel.png

• kernel_size – Valores mayores (≥15) ofrecen un aspecto más suave, mientras que valores menores (≤5) mantienen transiciones nítidas.
• pixel_size – El pixel‑art de 8‑bit suele tener entre 8 y 16 px; prueba con 4 para resultados “pixel‑perfecto” en imágenes muy pequeñas.
• edge_thresh – Configura un valor bajo (por ejemplo, 50) para obtener contornos negros más gruesos. Manténlo alto (>200) para eliminar la mayoría de los bordes.

Ejemplo: convertir un paisaje en 8‑bit retro

A continuación se muestra un ejemplo rápido de convertir una fotografía montañosa en alta resolución a pixel art de estilo retro:

python convert.py --input ./images/example_input_mountain.jpg \
  --kernel_size 12 \
  --pixel_size 12 \
  --edge_thresh 120 \
  --output ./output/mountain_pixel.png

La imagen resultante es una mezcla perfecta de gradientes de color suaves y bloques de píxel nítidos, evocando los primeros juegos de consola.

Ejecución en Colab

Si prefieres un entorno basado en web, copia el contenido del cuaderno convert.ipynb en Google Colab:

1. Sube el archivo convert.ipynb del repositorio.
2. Instala las dependencias con !pip install -r requirements.txt.
3. Sube un archivo de imagen.
4. Ejecuta las celdas para ver la conversión en vivo.

Este método es ideal para experimentos rápidos o compartir resultados con colaboradores.

Contribuir

¡El proyecto invita a colaboradores!

• Informes de errores – Abre un issue si encuentras un problema.
• Pull requests – Haz un fork, realiza cambios y envía una PR. Sigue el estilo existente y asegúrate de que todas las pruebas (si las hay) pasen.
• Mejoras de funcionalidades – Ideas como nuevos algoritmos de detección de bordes, una interfaz más interactiva o un modo de procesamiento por lotes son muy bienvenidas.

También puedes añadir documentación en tu idioma nativo o crear un tutorial para nuevos usuarios.

Comunidad y soporte

• Discussions de GitHub para preguntas generales.
• Discord (enlace en el README) para ayuda en tiempo real.
• Twitter @photo2pixel para actualizaciones.

Conclusión

Photo2Pixel demuestra cómo herramientas de procesamiento de imágenes potentes pueden empaquetarse en una aplicación de línea de comando simple y de código abierto. Ya sea que seas un desarrollador que busca integrar efectos de estilo pixel en un juego o un aficionado que desea crear arte retro, este proyecto te brinda control y flexibilidad sin la carga de herramientas manuales de pixel art.

Descarga el repositorio, juega con los parámetros y disfruta creando tu propia obra maestra de 8‑bit, todo en minutos.

¡Feliz creación de pixel‑art!