Skip to content

clv/vectorizer-ai-desktop

Repository files navigation

Vectorizer.AI Desktop

Vectorizer.AI Desktop is a lightweight Tauri app for local batch vectorization workflows. It complements the Vectorizer.AI website and CLI:

  • Website: interactive review, zoom/pan, and palette editing.
  • CLI: scripts and automation.
  • Desktop app: local file/folder queues, output presets, saved credentials, and handoff links back to the website for detailed review.

The desktop app calls the public Vectorizer.AI API. It does not embed the vectorization algorithm.

Current Capabilities

  • Add raster images or recursively add folders.
  • Drag and drop files/folders into the queue.
  • Choose output format: SVG, PDF, EPS, DXF, or PNG.
  • Choose API mode: production, preview, test, or test preview.
  • Save API Secret in the operating system credential store.
  • Save non-secret preferences in the user config directory.
  • Run queued jobs sequentially and save results to a local output folder.
  • Show credits charged/calculated when returned by the API.
  • Preserve retained Image Tokens when retention is enabled.
  • Open saved output files, reveal them in the file manager, or open retained results on vectorizer.ai for inspection/editing.

Development

Prerequisites:

  • Node.js
  • Rust stable toolchain
  • Platform requirements for Tauri v2

Install dependencies:

npm install

Run the frontend build:

npm run build

Run Rust checks:

cd src-tauri
cargo check

Run the app in development:

npm run desktop:dev

This is the fastest local loop. It opens the native Tauri window and serves the frontend through Vite with live rebuilds.

For review/testing of the latest compiled portable build, double-click Launch Dev.bat or run:

.\Launch Dev.bat

That launcher only opens dist-portable\windows-x64\Vectorizer.AI Desktop\Vectorizer.AI Desktop.exe; it does not compile.

Build desktop bundles:

npm run tauri build

Build a no-install Windows portable ZIP:

npm run portable:windows

This writes a runnable app folder and ZIP under dist-portable. For quick iteration after a build, run:

npm run portable:windows:run

The underlying raw Tauri executable is also available at:

src-tauri\target\release\vectorizer-ai-desktop.exe

Release Builds

GitHub Actions checks the app on Windows, macOS, and Ubuntu. To create a draft release with platform bundles, push a tag that starts with desktop-v:

git tag desktop-v0.1.0
git push origin desktop-v0.1.0

The release workflow uses tauri-apps/tauri-action and uploads the generated installers as draft release assets for review before publication. Windows releases also include a windows-x64-portable.zip asset for no-install review.

API Credentials

The app asks for the Vectorizer.AI API Id and API Secret. If credential saving is enabled, only the secret is written to the operating system credential store. The API Id and other preferences are stored in the app settings JSON.

Environment variables are not required.

Handoff To Website

When Review links is enabled, the app sends policy.retention_days with each vectorization request. If the API returns X-Image-Token, the job row includes a link to:

https://vectorizer.ai/images/{IMAGE_TOKEN}

That keeps the desktop app focused on local batch workflow while reusing the existing website for detailed inspection and palette editing.

About

Desktop batch workbench for Vectorizer.AI

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors