goku-image-to-svg-tool README

The project's README from github.com/goku-open/goku-image-to-svg-tool. As one markdown file: README.md.

🐵 悟空图片转SVG工具

基于 Vecto 引擎的图片矢量化工具:上传位图,自动转为干净可编辑的 SVG。

中文 English License Stars Streamlit Python

悟空图片转SVG工具 banner

把 Vecto 命令行引擎(开源 .NET 矢量化核心)包上一层 Streamlit Web 界面:不需要敲命令,选图即转、改参即重转,原图 / 矢量 / 分割视图三合一对比,导出 SVG 或按倍率渲染 PNG。

为什么选悟空图片转SVG工具?

对比

能力 悟空图片转SVG Vectorizer.AI Illustrator 图像描摹 Inkscape 位图描摹 vecto CLI(裸用)
开源免费 ✅ ❌ ❌ ✅ ✅
浏览器即用,免安装 ✅ ✅ ❌ ❌ ❌
上传即自动转换 ✅ ✅ ❌ ❌ ❌
调色板/风格/细节参数 ✅ ✅ ✅ ✅ ✅(命令行)
分割视图+滑块对比 ✅ 部分 ❌ ❌ ❌
中英双语界面 ✅ 部分 部分 ✅ ❌

对比基于各产品公开能力,以实际体验为准;Illustrator / Inkscape 与在线服务的功能随版本变化。

安装 / 在线使用

在线使用(推荐): image-to-svg.streamlit.app——免安装、打开即用。

需要本地运行:

git clone https://github.com/goku-open/goku-image-to-svg-tool.git
cd goku-image-to-svg-tool
pip install -r requirements.txt
streamlit run streamlit_app.py

打开 http://localhost:8501 即可使用。tools/vecto 二进制已随仓库提供(v0.4.2 linux-x64);如需要自行下载,见 Vecto Releases。

使用

启动后浏览器显示:

  You can now view your Streamlit app in your browser.

  Local URL: http://localhost:8501
  Network URL: http://192.168.x.x:8501
  1. 上传图片:支持 PNG / JPG / BMP / GIF / TGA / TIFF / WebP / PBM / PPM,上传即自动转换
  2. 调参数:右栏与 Vecto CLI 对齐——调色板(自动或指定颜色数,带色块预览)、风格、细节,改动即时重转
  3. 看效果:拖拽滑块对比原图 / 矢量 / 分割视图
  4. 导出:下载 SVG,或按缩放倍数渲染为 PNG

工作原理

Streamlit 前端 ──subprocess──▶ tools/vecto trace(位图 → SVG)──▶ 解析 stats
      ▲                                                              │
      └──────────── 滑块对比 + 导出 SVG / PNG(render) ◀──────────────┘

矢量化核心是 Vecto(.NET, MIT):ImageSharp 解码图片、多边形拟合生成矢量路径;本项目负责 Web 交互、参数透传、三视图对比与导出。

贡献与开发

支持

我养了两只猫,汤圆和饺子。如果你觉得悟空图片转SVG工具给你的生活带来了快乐,你可以喂它们 罐头食品 🥩。

License

MIT © 2026 Goku-Scraper。Vecto 引擎 © Daniel Mevit。

Keywords: 图片转矢量, 位图转SVG, 图片矢量化, svg 转换, 在线矢量化工具, vecto 引擎, streamlit 应用, 免费开源, 中英双语, image to vector, raster to svg, image tracing, bitmap to svg, svg converter, vector graphics, vecto engine, streamlit app, open source

Last updated: 2026-08-21T10:30:08+08:00

goku-image-to-svg-tool (goku-open/goku-image-to-svg-tool)

Searching Database…

328 ·GitHub
Goku-image-to-svg-tool
What is this?A Streamlit web app that wraps the open-source Vecto (.NET) vectorization engine to turn raster images like PNG or JPG into clean, editable SVG files, with a live original/vector/split-view comparison before you export.
Is this its own vectorizer, or just a UI on top of another engine?It's a Streamlit front-end wrapped around the Vecto CLI engine (an open-source .NET vectorization core). The engine does the actual tracing (ImageSharp decode plus polygon fitting); this project just handles the web UI, parameter passing, three-way preview, and export.
How do I start using it?Easiest way is to open the hosted instance at image-to-svg.streamlit.app in a browser, no install needed. To run it locally, clone the repo and launch the Streamlit app; the Vecto binary (v0.4.2, linux-x64) already ships inside tools/vecto.
Do I need to download the Vecto engine myself?No, a single-file Vecto binary (v0.4.2, linux-x64) is bundled directly in the repo at tools/vecto, so it works out of the box; you'd only grab a different build from Vecto's own releases if you're not on linux-x64.
Any catch when running it locally or heavily?The included Vecto binary targets linux-x64 only, so other platforms need a manual download; also, a single conversion can peak at 60-490MB of memory, which the author says is fine for personal use but worth knowing before scaling it up.
What image formats can I upload?PNG, JPG, BMP, GIF, TGA, TIFF, WebP, PBM, and PPM are all accepted, and conversion starts automatically the moment you upload.
How does this compare to Vectorizer.AI or Inkscape's bitmap trace?Per the README's comparison table, it matches Vectorizer.AI on browser-based, auto-on-upload conversion while staying fully open-source and free like Inkscape, and it adds a draggable split-view comparison and bilingual UI that none of the alternatives combine.
Can I also get a raster image back out, not just SVG?Yes, after tracing you can export either the vector SVG or render it back to PNG at a chosen zoom/scale multiplier.
Is the parameter control limited compared to using Vecto directly?No, the README states the UI exposes the full Vecto CLI parameter set unmodified, including palette (auto or fixed color count with swatch preview), style, detail, and diagnostic info.
Is the interface only in Chinese?No, the app has a one-click language toggle between Chinese and English.
What are similar projects?sharp, cell-lct, PCB_lightgraph_Portable, photosuite, open-pencil-cloud, vectorcraft, floorplan-3d, pdfkit
Which topics is it in?png, streamlit, vector-graphics, bilingual, converter, design-tools, opensource, image-editing, svg, graphics, design, image-processing
Creator
goku-open
Size
29.6 MB
Stars
328
Updated
CommitAug 21
Age
2mo
Commits · 90 Days