Covecto

Dual-engine image vectorization — pixel-exact for icons, smooth curves for art.

Documentation · Getting Started · Changelog

Why Covecto?

Most vectorizers are one-trick — good at photos or good at icons, never both. Covecto ships two engines and auto-selects the right one:

Install

# One-line install (Linux/macOS/Windows)
curl -fsSL https://codecora.dev/covecto/install | sh

# Cargo
cargo install covecto

# Docker
docker pull ghcr.io/codecoradev/covecto:latest

Quick Start

# Auto-detect best engine
covecto input.png -o output.svg

# Force pixel-exact (great for icons)
covecto icon.png --engine pixel-exact -o icon.svg

# Spline for photos with optimization
covecto photo.jpg --engine spline --optimize -o photo.svg

# Built-in profile (tunes multiple params at once)
covecto logo.png --profile logo -o logo.svg

# Batch: entire directory
covecto ./icons/ --engine pixel-exact -o ./output/

# Recursive scan with glob
covecto "screenshots/*.png" --recursive -o ./vectorized/

# Output formats: SVG (default), PDF, EPS
covecto input.png --format pdf -o input.pdf

REST API

# Start the server
covecto serve --port 3000

# Vectorize
curl -F "file=@input.png" -F "engine=auto" http://localhost:3000/v1/vectorize

# Optimize existing SVG
curl -F "file=@input.svg" http://localhost:3000/v1/optimize

# Health check
curl http://localhost:3000/v1/health

Full API spec: openapi.yaml

Docker

# API server mode
docker run -p 3000:3000 ghcr.io/codecoradev/covecto:latest

# Vectorize a local file
docker run -v $(pwd):/data ghcr.io/codecoradev/covecto:latest \
  vectorize /data/input.png -o /data/output.svg

Rust Library

use covecto_core::{vectorize, VectorizeRequest, Engine, VectorizeConfig};

let img = image::open("input.png").unwrap().to_rgba8();
let request = VectorizeRequest::new(img)
    .with_config(VectorizeConfig {
        engine: Engine::Auto,
        ..Default::default()
    });

let result = vectorize(&request).unwrap();
println!("{} paths in {}ms", result.metadata.path_count, result.metadata.processing_time_ms);

License

MIT