| name | svg-generator |
| description | Generate SVG images using the Quiver AI API. Use when the user needs to create SVGs from text descriptions (logos, icons, illustrations, calligraphy, diagrams) or convert raster images (PNG, JPG, WebP) to SVG vector format. Triggers include "generate an SVG", "create a vector image", "make an SVG logo", "convert to SVG", "vectorize this image", or any AI-powered SVG creation task. |
SVG Generator
Generate SVGs from text prompts or convert raster images to SVG using the Quiver AI API.
Prerequisites
Set your API key as an environment variable:
export QUIVER_API_KEY="your-api-key-here"
(Also accepts QUIVER_AI_API_KEY as a fallback.)
Workflow Decision Tree
- Does the user want to create an SVG from a text description? โ Use Text-to-SVG Generation
- Does the user want to convert an existing image to SVG? โ Use Image-to-SVG Vectorization
Text-to-SVG Generation
Generate SVGs from natural language descriptions โ logos, icons, illustrations, calligraphy, diagrams, and more.
Script: scripts/generate_svg.py
Basic Usage
python3 scripts/generate_svg.py --prompt "a minimalist mountain logo in blue"
With Style Instructions
python3 scripts/generate_svg.py \
--prompt "a coffee cup icon" \
--instructions "flat design, single color, no gradients" \
--output coffee_icon.svg
Multiple Variations
python3 scripts/generate_svg.py \
--prompt "abstract geometric pattern" \
--n 4 \
--temperature 1.5 \
--output-dir ./variations
With Reference Images
python3 scripts/generate_svg.py \
--prompt "a logo similar to this style" \
--references https://example.com/style-ref.png
All Options
| Flag | Required | Description |
|---|
--prompt | Yes | Text description of the SVG |
--output | No | Output filename (default: generated_svg_TIMESTAMP.svg) |
--output-dir | No | Output directory (default: .) |
--instructions | No | Style guidance |
--references | No | Reference image URLs (max 4) |
--n | No | Number of SVGs (1-16, default: 1) |
--temperature | No | Randomness 0-2 (default: 1) |
--model | No | Model name (default: arrow-preview) |
--timeout | No | Request timeout in seconds (default: 600) |
Image-to-SVG Vectorization
Convert raster images (PNG, JPG, WebP) to clean SVG vector format. Accepts local files or URLs.
Script: scripts/vectorize_svg.py
From a Local File
python3 scripts/vectorize_svg.py --image logo.png --output logo.svg
From a URL
python3 scripts/vectorize_svg.py --image https://example.com/photo.jpg --output vectorized.svg
With Auto-Crop and Target Size
python3 scripts/vectorize_svg.py \
--image icon.png \
--auto-crop \
--target-size 512 \
--output clean_icon.svg
All Options
| Flag | Required | Description |
|---|
--image | Yes | Local file path or URL |
--output | No | Output filename (default: vectorized_TIMESTAMP.svg) |
--output-dir | No | Output directory (default: .) |
--auto-crop | No | Enable automatic cropping (flag) |
--target-size | No | Target size in pixels (128-4096) |
--n | No | Number of SVGs (1-16, default: 1) |
--temperature | No | Randomness 0-2 (default: 1) |
--model | No | Model name (default: arrow-preview) |
--timeout | No | Request timeout in seconds (default: 600) |
Output Handling
- stdout: Output file path(s), one per line โ use this to locate generated files
- stderr: Token usage statistics and any error messages
- When
--n > 1, files are suffixed with _1, _2, etc.
Resources
