---
id: vtracer
version: "0.6.15"
license: MIT
license_treatment: permissive
maintenance: active
---

# vtracer — Python bindings for the Rust Vtracer raster-to-vector library

License: permissive · Maintenance: active · Downloads: 298.9K/mo

## What it is and what it does

VTracer is a Python binding to a Rust-based raster-to-vector converter that transforms bitmap images into scalable SVG graphics. It processes images through a pipeline that can handle colored high-resolution scans as well as low-resolution pixel art, outputting compact vector files with fewer shapes than traditional tools. The package offers multiple modes: multicolor vectorization for photographs and scans, binary mode for line art and technical drawings, and configurable parameters for curve fitting, color precision, and shape hierarchy.

The tool is designed for both high-resolution document scanning (originally built for historic blueprints) and retro game artwork. It accepts input as file paths, raw image bytes, or pixel arrays, and outputs SVG strings or files. With no runtime dependencies and prebuilt wheels for most platforms, installation is straightforward on standard systems, though unsupported architectures may require compilation.

Use it for:

- Convert scanned documents or blueprints to vector format for archival, editing, or CAD integration.
- Trace pixel art or retro game graphics to scalable SVG for web or print use.
- Batch-convert photographs to stylized vector graphics with color or binary mode.
- Process image data from HTTP requests or in-memory sources without intermediate file I/O.
- Generate compact vector graphics from high-resolution images for reduced file size.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Converts raster images (JPG, PNG) into vector graphics (SVG) by tracing curves and shapes, supporting both multicolor and binary (line art) modes.

Yes, if you need to convert raster images to SVG. The package is actively maintained, has no known vulnerabilities, carries a permissive MIT license, and offers a straightforward API with both file and in-memory workflows. Install friction is moderate due to compiled bindings, but prebuilt wheels cover most platforms. No runtime dependencies simplifies deployment.

## Install

pip install vtracer
uv add vtracer
poetry add vtracer

## Installing vtracer

Before you install: Medium install friction due to compiled Rust bindings, but prebuilt wheels cover common platforms (Linux x86_64, ARM, macOS, Windows). Package is actively maintained with recent releases.

License in practice: MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute the package freely provided you include the license notice.

Quickstart:

pip install vtracer

import vtracer

# Multicolor SVG from file
vtracer.convert_image_to_svg_py('/path/to/image.jpg', '/path/to/output.svg')

# Binary (line art) mode
vtracer.convert_image_to_svg_py('/path/to/image.jpg', '/path/to/output.svg', colormode='binary')

# From raw bytes
svg_str = vtracer.convert_raw_image_to_svg(image_bytes, img_format='jpg')

Requires Python 3.7 or later; compiled wheels available for common platforms but may require build tools on unsupported architectures.

Verify before relying:

- Performance characteristics and memory usage for gigapixel-scale images mentioned in description.
- Specific image formats supported beyond JPG and PNG.
- Comparison of output compactness and shape count versus Potrace or Adobe Illustrator's Image Trace in practice.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 298.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

raster to vector conversion, image to svg converter, trace image to vector, rasterize to vectorize, image vectorization python, convert jpg png to svg, curve tracing image processing, image-processing, vectorization, rust-binding

[View on SkillFed](https://skillfed.io/packages/vtracer) · [View on PyPI](https://pypi.org/project/vtracer/)