Progettato per workflow IA

Gli agenti IA non hanno tempo per correggere i tuoi bug d'ambiente

getwebp è il nodo di elaborazione immagini locale più compatibile con l'IA al mondo. Un binario. Zero dipendenze. Output JSON. Funziona ovunque giri il tuo agente.

GetWebP è un ottimizzatore di immagini senza dipendenze, basato su WASM, pensato per i flussi di lavoro degli agenti IA. Accetta output strutturato JSON, legge da stdin/stdout e converte PNG, JPG, GIF, TIFF e BMP in WebP e AVIF — tutto in locale, senza caricamenti sul cloud e senza chiavi API. Un unico comando npx installa tutto ciò di cui un agente IA ha bisogno per elaborare immagini in pipeline CI/CD, assistenti di codifica o flussi di lavoro autonomi.

terminal — bash
$
{
"success": true,
"processed": 24,
"failed": 0,
"totalInputSize": "12.4 MB",
"totalOutputSize": "2.1 MB",
"compressionRatio": "83%",
"files": [
{
"input": "hero.jpg",
"output": "hero.webp",
"saved": "89%"
},
{
"input": "product-01.jpg",
"output": "product-01.webp",
"saved": "81%"
},
"... 22 more files"
]
}
✓ 24 files processed in 1.2s — 83% smaller

Il problema

Il tuo strumento immagini sta rompendo il tuo agente

Ogni dipendenza è un potenziale punto di guasto per i tuoi workflow IA.

pip install fallisce negli ambienti sandbox

Pillow richiede estensioni C compilate. Gli agenti sandbox e i container Docker ristretti le rifiutano.

I conflitti di versione ImageMagick rompono il CI

Differenze API v6 vs v7. Delegate mancanti. Conflitti di pacchetti di sistema. La tua pipeline cade alle 3 di notte.

Le API cloud espongono i tuoi dati

Inviare immagini ad API esterne significa rischio di conformità, latenza, limiti di frequenza e costo per immagine.

Configurazione complessa = comportamento agente imprevedibile

Quando l'ambiente è fragile, il tuo agente non riesce a distinguere i guasti degli strumenti dagli errori reali.

La soluzione

Un binario. Totale prevedibilità.

getwebp è progettato da zero per l'uso programmatico.

Binario statico unico

Nessun runtime. Nessuna dipendenza. Nessun pip, brew, apt-get. Scarica ed esegui. Funziona in Docker FROM scratch.

Risolto

Output JSON strutturato

Ogni operazione restituisce JSON analizzabile dalla macchina. Il tuo agente legge successo, statistiche ed errori senza analizzare testo umano.

Risolto

Comportamento deterministico

Stesso binario, stesso comportamento, ovunque. macOS, Linux, Windows, ARM, x86. Il tuo agente sa esattamente cosa aspettarsi.

Risolto

Funzionalità compatibili IA

Progettato per il controllo programmatico

Zero dipendenze

npm install niente. apt-get niente. Eseguilo e basta. Nessun binding nativo, nessuna libreria di sistema, nessuna sorpresa.

$ getwebp ./images
Nessuna configurazione

Modalità output JSON

Ogni operazione restituisce JSON strutturato. Analizzalo, registralo, agisci. Perfetto per i pattern di utilizzo strumenti LLM.

Flag --json

Supporto stdin/stdout

Nativo per le pipe. Legge da stdin, scrive su stdout. Componi con qualsiasi comando shell o catena di strumenti IA.

Pipe-friendly

Vera elaborazione batch

Elabora 1000 immagini in un comando. Ricevi un array JSON con i risultati per file. Nessun loop.

1000 file, 1 comando

Codici di uscita prevedibili

0 = successo, non-zero = errore. Il tuo agente lo sa immediatamente senza analizzare l'output.

Leggibile dall'agente

Binario multipiattaforma

Stesso binario, stesso comportamento su macOS, Linux, Windows, ARM, x86. CI e locale coincidono sempre.

Universale

Esempi di codice

Inseriscilo in qualsiasi workflow

#!/bin/bash
# Process images and parse JSON output
RESULT=$(getwebp ./images/*.jpg --json)
if [ $? -eq 0 ]; then
SAVED=$(echo $RESULT | jq -r '.compressionRatio')
COUNT=$(echo $RESULT | jq -r '.processed')
echo "✓ Processed $COUNT files, saved $SAVED"
else
echo "✗ Error: $(echo $RESULT | jq -r '.error')"
exit 1
fi
Output JSON

Leggibile dalla macchina per impostazione predefinita

Con --json, ogni operazione restituisce dati strutturati su cui il tuo agente può ragionare.

Prova un'operazione:
Input Command
Exit code: 0
$getwebp hero.jpg --json
JSON Output
{
  "success": true,
  "operation": "convert",
  "input": {
    "file": "hero.jpg",
    "size": "1.2 MB",
    "format": "JPEG"
  },
  "output": {
    "file": "hero.webp",
    "size": "142 KB",
    "format": "WebP"
  },
  "saved": "88%",
  "duration": "0.3s"
}
Ecosistema

Funziona con il tuo stack IA

Nessun adattatore personalizzato. Se riesce a eseguire un comando shell, funziona con getwebp.

Claude CodeAI Coding
GitHub ActionsCI/CD
DockerContainers
n8nAutomation
PythonScripting
Bash / ShellShell

Works with any tool that can run a shell command

Perché getwebp

La scelta compatibile IA

Rispetto ad altri strumenti di elaborazione immagini per workflow programmatici.

FeaturesgetwebpBest for AIImageMagickPillowCloudinary APIsharp (Node)
Zero dipendenze
Output JSON
100% offline/locale
Binario unico
Codici di uscita prevedibili
Output array JSON batch
Identico multipiattaforma
Pronto per agenti IA
Workflow reali

Come i team IA usano getwebp

Pipeline di preprocessing immagini LLM

Ridimensiona e comprimi le immagini prima di inviarle ai modelli visivi per ridurre i costi in token fino all'80%. getwebp gestisce l'intero batch con un comando che restituisce JSON.

Workflow

User Inputimage path
getwebpresize + compress
Vision APIGPT-4V / Claude
Resultparsed JSON

Example

python
# Reduce image size before sending to GPT-4V
result = subprocess.run([
    "getwebp", image_path,
    "--resize", "1024x1024",
    "--json"
], capture_output=True, text=True)
data = json.loads(result.stdout)
# Tokens saved: ~80% for typical product photos

FAQ

Domande comuni degli sviluppatori IA

I tuoi agenti stanno aspettando.

Smetti di combattere le dipendenze.

Un comando. Zero configurazione. Output JSON. Lo strumento immagini che mancava al tuo stack IA.

npx getwebp@latest --help

No signup. No credit card. Works offline.