Pre-release

This release is a pre-release and may not be stable for production use.

vtracer (Python)

Python bindings for the vtracer raster-to-vector framework. Built with pyo3 + maturin; the core Rust crate stays pure (no I/O), and this crate adds image decoding and a Pythonic API.

Install

pip install vtracer==1.0.0a3

Usage

import vtracer

# one-liners
vtracer.convert_file("in.png", "out.svg")
svg = vtracer.convert_bytes(open("in.png", "rb").read())          # -> str
svg = vtracer.convert_pixels(rgba_bytes, width, height)           # raw RGBA8

# a rich, reusable configuration object
cfg = vtracer.Config(mode="polygon", filter_speckle=8)
cfg.hierarchical = "cutout"          # seam-free mosaic
cfg.palette = ["#1b1b1b", "#e0c088", "#5a7d3c"]   # snap to a fixed palette
cfg.max_colors = 8                   # or auto-quantize
cfg.optimize = 2
svg = cfg.convert_bytes(data)

# presets
vtracer.Config.poster().convert_file("photo.jpg", "poster.svg")
vtracer.Config.bw().convert_file("scan.png", "lineart.svg")

`Config`

Constructor keyword arguments (all optional) — also exposed as mutable properties, plus the presets Config.bw(), Config.poster(), Config.photo():

arg	default	notes
`clustering`	`"color-cluster"`	`"color-cluster"`, `"bw"`, or `"watershed"`
`hierarchical`	`"stacked"`	`"stacked"` or `"cutout"` (mosaic)
`mode`	`"spline"`	`"pixel"`, `"polygon"`, `"spline"`
`filter_speckle`	`4`	discard patches smaller than X px
`color_precision`	`6`	significant bits per channel
`layer_difference`	`16`	color diff between gradient layers
`corner_threshold`	`60`	degrees
`length_threshold`	`4.0`	px
`max_iterations`	`10`
`splice_threshold`	`45`	degrees
`simplify`	`None`	curve simplification tolerance in px (try 1–2.5)
`path_precision`	`2`	output decimal places
`palette`	`None`	list of `#rrggbb` strings
`max_colors`	`None`	auto-quantize target
`optimize`	`1`	`0` off, `1` quantize+cleanup, `2` + shorthands
`binary_threshold`	`128`	bw: fixed cutoff, foreground below it
`adaptive`	`False`	bw: Bradley–Roth adaptive thresholding
`adaptive_window`	`0`	bw adaptive: window px (`0` = auto)
`adaptive_t`	`15.0`	bw adaptive: % below local mean
`watershed_detail`	`128`	watershed: hierarchy cut level 0..=255

Each Config has convert_file(input, output), convert_bytes(data, format=None) -> str, and convert_pixels(rgba, width, height) -> str.

Build from source

maturin develop            # into the active virtualenv
maturin build --release    # produce a wheel

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vtracer-1.0.0a3.tar.gz (100.0 kB view details)

Uploaded Aug 1, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

vtracer-1.0.0a3-cp38-abi3-win_arm64.whl (901.8 kB view details)

Uploaded Aug 1, 2026 CPython 3.8+Windows ARM64

vtracer-1.0.0a3-cp38-abi3-win_amd64.whl (971.7 kB view details)

Uploaded Aug 1, 2026 CPython 3.8+Windows x86-64

vtracer-1.0.0a3-cp38-abi3-win32.whl (923.9 kB view details)

Uploaded Aug 1, 2026 CPython 3.8+Windows x86

vtracer-1.0.0a3-cp38-abi3-musllinux_1_2_x86_64.whl (1.4 MB view details)

Uploaded Aug 1, 2026 CPython 3.8+musllinux: musl 1.2+ x86-64

vtracer-1.0.0a3-cp38-abi3-musllinux_1_2_i686.whl (1.4 MB view details)

Uploaded Aug 1, 2026 CPython 3.8+musllinux: musl 1.2+ i686

vtracer-1.0.0a3-cp38-abi3-musllinux_1_2_armv7l.whl (1.4 MB view details)

Uploaded Aug 1, 2026 CPython 3.8+musllinux: musl 1.2+ ARMv7l

vtracer-1.0.0a3-cp38-abi3-musllinux_1_2_aarch64.whl (1.3 MB view details)

Uploaded Aug 1, 2026 CPython 3.8+musllinux: musl 1.2+ ARM64

vtracer-1.0.0a3-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.2 MB view details)

Uploaded Aug 1, 2026 CPython 3.8+manylinux: glibc 2.17+ x86-64

vtracer-1.0.0a3-cp38-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl (1.2 MB view details)

Uploaded Aug 1, 2026 CPython 3.8+manylinux: glibc 2.17+ s390x

vtracer-1.0.0a3-cp38-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (1.6 MB view details)

Uploaded Aug 1, 2026 CPython 3.8+manylinux: glibc 2.17+ ppc64le

vtracer-1.0.0a3-cp38-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (1.2 MB view details)

Uploaded Aug 1, 2026 CPython 3.8+manylinux: glibc 2.17+ ARMv7l

vtracer-1.0.0a3-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.2 MB view details)

Uploaded Aug 1, 2026 CPython 3.8+manylinux: glibc 2.17+ ARM64

vtracer-1.0.0a3-cp38-abi3-manylinux_2_5_i686.manylinux1_i686.whl (1.3 MB view details)

Uploaded Aug 1, 2026 CPython 3.8+manylinux: glibc 2.5+ i686

vtracer-1.0.0a3-cp38-abi3-macosx_11_0_arm64.whl (1.1 MB view details)

Uploaded Aug 1, 2026 CPython 3.8+macOS 11.0+ ARM64

vtracer-1.0.0a3-cp38-abi3-macosx_10_12_x86_64.whl (1.1 MB view details)

Uploaded Aug 1, 2026 CPython 3.8+macOS 10.12+ x86-64

File details

Details for the file vtracer-1.0.0a3.tar.gz.

File metadata

Download URL: vtracer-1.0.0a3.tar.gz
Upload date: Aug 1, 2026
Size: 100.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for vtracer-1.0.0a3.tar.gz
Algorithm	Hash digest
SHA256	`9eb224154ab2977671b4ca6005c94f756826a4bf9d9be38ba3e2e123488d37a1`
MD5	`6820570f34441921a6357ec2dd2691b7`
BLAKE2b-256	`effb54ab0e5436a5c1660d935ee417e12cb981e65c9300ffb9ad8b9f98472adb`

Algorithm	Hash digest
SHA256	`a360b1f68541100f439097f029b680e11ac33ba54bf4abe67cc5738dbe5789a7`
MD5	`fdfadc7037b6a9a33a3486727bc23395`
BLAKE2b-256	`e1a3553743b7fea521d2f56aec38fabfda794d996eac00b08ba85a429e26a028`

Algorithm	Hash digest
SHA256	`0685916b1c9bddaaf3203080416082b9f49df3a52e53f13c69595eaf9af2e709`
MD5	`16aa24a3b8e606425d34785b28cfae81`
BLAKE2b-256	`0d210c92a34c52f153f3cd60c68345aed0d21107bc27a652b719577e369802f6`

Algorithm	Hash digest
SHA256	`09d510dee748d9ea9b7d9f41497ac07c9a2f8cd4874e8084af385e99be6b2134`
MD5	`8bdaf656ab049940671fffba9d7e349f`
BLAKE2b-256	`779b25378eed0f877d42dc8c2c2ca90e811d05cddee87b2c12a54e80d160a17e`

Algorithm	Hash digest
SHA256	`a427c73faa8c6e4dde89e40e0da93dd4cae784fa9d4dc33181a3088cffe1b3c7`
MD5	`86f04b0bd23619484172dd7106b0974e`
BLAKE2b-256	`dd5a55a687fdfc056e47f209956b2429bf784ad1acf20bbd7296e530a5e3a80d`

Algorithm	Hash digest
SHA256	`b74432286d4a34c408e51b0ef1e171637e0f35c2c90b79c7dd27663cfb6ddc3b`
MD5	`b3e47b85559f3f94b3f0915c93fb6b15`
BLAKE2b-256	`c5698e0736c6d8c47d342362498837ca6faf6eefcb6b3cdc92266ca7683471e9`

Algorithm	Hash digest
SHA256	`7ec02220ccc0debb078e462e05d5dee212722cda4a83e7167a8c9349f9169005`
MD5	`6d713610c84d00f2b9b3c53a6ff258a3`
BLAKE2b-256	`101f3faefcf06f51d931ea0b3fbb2a4ece257036ca3ce8d39ab4e31dbd115ebc`

Algorithm	Hash digest
SHA256	`d0fe54b4b0216aacb23bce4b760a7219322c92a6865084c44f3ac525079a9dc2`
MD5	`ed9d02bc36ca7e8bcaadd3e84ecc44ee`
BLAKE2b-256	`1f96d9abb4d5d1ef83fa4b63a735d4c3778c19f3b22f14d93605d7e99651fb57`

Algorithm	Hash digest
SHA256	`83e8f59f481397f856473e2d04365d426a29012c783edda0ac1720c7716f127c`
MD5	`3155a0e5b836cf4284ce14d6483251e1`
BLAKE2b-256	`a5f4b31c178ad7ffb619ddab724c955d1acb8d4cfc18eb626de9d9783417faa1`

Algorithm	Hash digest
SHA256	`7bb4e4be9e25180538293241c3b57157cbe46655e30cdac8b14eb55fbac3fd48`
MD5	`a2bf17575fb2d117e954011433411384`
BLAKE2b-256	`167f0109ed5c03a3eb9ca1c6be27604a173050ac86fbaa4833b8a7833b7b2ac7`

Algorithm	Hash digest
SHA256	`49ba33bfe545a1aa35b5b77257abbfaecea9eaf4d528a160070d1da21298d9ed`
MD5	`6cae75a13e4a486a16669bbacd460e32`
BLAKE2b-256	`20a3b599cb49c3324762db09ff9295269017a14be5922decb4b4de1d8c8320f1`

Algorithm	Hash digest
SHA256	`f3032b44137405e77affd16218a5b96127d49307de13446158cb9058e724c402`
MD5	`755e1a385b5262fe039da1804f6c2e47`
BLAKE2b-256	`5447f4cc0a3f17516ba29d47ce5e511e09f10d00242d4430fa5e8f4f0da3aaca`

Algorithm	Hash digest
SHA256	`b051be5b8a3dd2597b9c6eb52fc3a34a10f8e391d9931c044aa5519bf0553132`
MD5	`0adbb524f0561474a33ee22ab232a379`
BLAKE2b-256	`03c82bf793053cc2d77f642a6c31fa17564a15b37f3acbbd94ca041912c1fb2f`

Algorithm	Hash digest
SHA256	`3caec97c96ed1695b5a2f3fbb3da3c22c6132ace79ad30d6db4c263e64fd4547`
MD5	`289c8fdaab510d3dbc7da50267cf1428`
BLAKE2b-256	`2004c9ba7e6a0a52a1fb2e098dd0394b091d63f91d1b12650a36f4f41b7b9a51`

Algorithm	Hash digest
SHA256	`9fd2b8420347c15f254a7f44a1245bbebbdca40ed00aec1e98bb6a9e6240f6e3`
MD5	`4bbe558c664dc762ceb2da425fcee6f2`
BLAKE2b-256	`82245cea38c10bff226995aa735f5659ab2fb1d56a795c7f609bb299e373f391`

Algorithm	Hash digest
SHA256	`1e153196530285aa5146cd3c8564fba5d79cfde4d25bde3753815e3954ffa4f7`
MD5	`302064e4071ceff84f787fae90fcb7e9`
BLAKE2b-256	`365e023f17b1592a69014d3e49641456f9e239a790e6e439a3024eccbb5a0343`

vtracer 1.0.0a3

vtracer (Python)

Install

Usage

Config

Build from source

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License

Requires

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

Release history Release notifications | RSS feed

`Config`