https://github.com/glastor-dev/kraken

Optimiza y convierte imágenes directamente en el navegador (batch), con redimensionado, métricas de ahorro y descarga en ZIP. Incluye renombrado sugerido por IA (opcional) vía endpoint serverless para mantener tu API key fuera del frontend.
https://github.com/glastor-dev/kraken

Last synced: 15 days ago
JSON representation

Optimiza y convierte imágenes directamente en el navegador (batch), con redimensionado, métricas de ahorro y descarga en ZIP. Incluye renombrado sugerido por IA (opcional) vía endpoint serverless para mantener tu API key fuera del frontend.

• Host: GitHub
• URL: https://github.com/glastor-dev/kraken
• Owner: glastor-dev
• License: gpl-3.0
• Created: 2026-01-01T19:05:30.000Z (about 1 month ago)
• Default Branch: master
• Last Pushed: 2026-01-02T04:02:53.000Z (about 1 month ago)
• Last Synced: 2026-01-07T05:47:37.727Z (about 1 month ago)
• Language: TypeScript
• Homepage: https://kraken-woad.vercel.app
• Size: 471 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: .github/CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: .github/CODE_OF_CONDUCT.md
  • Citation: CITATION.cff
  • Codeowners: .github/CODEOWNERS
  • Security: .github/SECURITY.md
  • Support: .github/SUPPORT.md

Awesome Lists containing this project

README

          
# kraken

Optimiza y convierte imágenes directamente en el navegador (batch), con redimensionado, métricas de ahorro y descarga en ZIP. Incluye renombrado sugerido por IA (opcional) vía endpoint serverless para mantener tu API key fuera del frontend.

[https://github.com/glastor-dev/kraken](https://github.com/glastor-dev/kraken)

[![CI](https://github.com/glastor-dev/kraken/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/glastor-dev/kraken/actions/workflows/ci.yml)

[![CodeQL](https://github.com/glastor-dev/kraken/actions/workflows/codeql.yml/badge.svg?branch=master)](https://github.com/glastor-dev/kraken/actions/workflows/codeql.yml)

[![License](https://img.shields.io/github/license/glastor-dev/kraken)](LICENSE)

[![Stars](https://img.shields.io/github/stars/glastor-dev/kraken?style=flat)](https://github.com/glastor-dev/kraken/stargazers)

[![Issues](https://img.shields.io/github/issues/glastor-dev/kraken)](https://github.com/glastor-dev/kraken/issues)

[![Last Commit](https://img.shields.io/github/last-commit/glastor-dev/kraken/master)](https://github.com/glastor-dev/kraken/commits/master)

## Capturas

![kraken - pendiente](assets/Kraken1.png)

![kraken - completado](assets/Kraken2.png)

## Features

- Procesamiento en lote (batch) con estado por archivo y descarga en ZIP.

- Conversión de formato (p. ej. WebP/AVIF/JPEG/PNG) y control de calidad.

- Redimensionado previo para respetar `maxWidth` / `maxHeight`.

- Vista previa y métricas de ahorro (tamaño original vs optimizado).

- Renombrado sugerido por IA (opcional) vía `/api/suggest-name`.

## Stack

- Vite + React + TypeScript

- `browser-image-compression` + `JSZip`

- Vercel Functions (`/api/*`) para IA con Gemini (`@google/genai`)

## Requisitos

- Node.js 20+

## Uso local

1. Instalar dependencias:

   - `npm install`

2. Copiar `.env.example` a `.env.local` y completar tu clave (solo para dev / funciones serverless):

   - `GEMINI_API_KEY=...`

3. Ejecutar en desarrollo:

   - `npm run dev`

## Deploy en Vercel

- El proyecto está preparado como SPA + Functions.

- Configura `GEMINI_API_KEY` como variable de entorno en Vercel.

- Luego despliega normalmente desde el repo.

## Scripts

- `npm run dev` — desarrollo

- `npm run build` — build de producción

- `npm run preview` — preview del build

## Seguridad

- No coloques `GEMINI_API_KEY` en el frontend.

- El renombrado IA se resuelve en el servidor vía `/api/suggest-name`.

## Contribuir

Lee [CONTRIBUTING.md](CONTRIBUTING.md). Reportes y sugerencias en [Issues](https://github.com/glastor-dev/kraken/issues).

## Licencia

Ver [LICENSE](LICENSE).