vectify-simplify 1.0.3

Enterprise-grade AI image upscaling and multi-threaded vectorization engine.

🚀 Vectify Simplify V8

Vectify Simplify is an enterprise-grade, high-performance Python library that combines Artificial Intelligence (ONNX) with advanced mathematical tracing to convert raster images (JPG, PNG) into pixel-perfect, scalable vector graphics (SVG).

✨ Key Features

• 🏎️ Hardware Acceleration: Auto-detects CPU, NVIDIA GPUs (CUDA), and Intel/AMD graphics.
• 🧠 AI Super-Resolution: Built-in ONNX upscaling.
• 👻 Native Alpha: Preserves PNG transparency.
• 🎨 Smart Quantization: Vectorize with up to 64 strict colors.

---

📦 Installation

pip install vectify-simplify

(Optional) For GPU Acceleration:

• NVIDIA: pip install onnxruntime-gpu
• Intel/AMD (Windows): pip install onnxruntime-directml

---

🚀 Usage Examples

1. "Lazy Mode" (Automatic Preset)

Perfect for standard photographs. It automatically upscales, refines, and traces using optimal settings.

from vectify.core import VectifyEngine

# 1. Initialize engine (Auto-detects best hardware)
engine = VectifyEngine(mode="auto")

# 2. Vectorize with a single line
result = engine.vectorize(
    image_path="photo.png", 
    output_path="output.svg", 
    preset="photo" 
)

print(f"Success! SVG created with {result['colors_used']} layers.")

2. "Hybrid Mode" (Preset + Custom Overrides)

Want to use the logo preset but force a specific number of colors? You can override any parameter.

from vectify.core import VectifyEngine

engine = VectifyEngine()

result = engine.vectorize(
    image_path="logo.png", 
    output_path="clean.svg", 
    preset="logo",            # Start with logo defaults
    max_colors=5,             # Override: Force exactly 5 colors
    solid_fill=True,          # Override: Close micro-gaps mathematically
    detail_level="high"       # Ensure sharp corners
)

3. Extract Color Palette

Need to know the dominant colors of an image before vectorizing?

from vectify.core import VectifyEngine

engine = VectifyEngine()
palette = engine.analyze_palette("art.png", max_colors=5)

for color in palette: 
    print(f"Hex: {color['hex']} | Area: {color['percentage']}%")

---

🎛️ Configuration Attributes

When overriding parameters in the vectorize() function, use these exact options:

Parameter	Type/Options	Description
preset	"photo", "logo", "illustration"	Base settings configuration.
max_colors	int (e.g., 16, 32)	Maximum number of color layers to extract.
detail_level	"low", "medium", "high"	Polygon count and curve accuracy.
smoothing_level	"low", "normal", "high"	Curve smoothing (Bezier optimization).
solid_fill	True, False	Applies morphological closing to heal transparent micro-gaps.

---

License: MIT License. Free for commercial and personal use.