DEV Community

dutchbase
dutchbase

Posted on

I built an open-source CLI image converter with a Web UI (and support for AI agents)

#cli #node #opensource #showdev

When building websites and automation workflows, I constantly ran into the same problem:

I just needed to convert an image quickly...

PNG → WebP
JPG → AVIF
Batch conversions
Quick optimizations

There are plenty of GUI tools, but they usually require opening an app or website, dragging files around, exporting again, running into limitations, etc.

And when working in scripts or automation pipelines, those tools are basically useless.

So I built img-convert.

An open-source CLI image converter that also includes a local Web UI and is designed to work well inside automation workflows and AI agents.

GitHub:
https://github.com/dutchbase/img-converter

npm:
https://www.npmjs.com/package/@dutchbase/img-convert

What it does

img-convert converts images between common formats like:

  • JPG
  • PNG
  • WebP
  • AVIF

It’s designed to be:

  • fast
  • scriptable
  • predictable for automation
  • easy to use from the command line

Example:

npx @dutchbase/img-convert input.png output.webp
Enter fullscreen mode Exit fullscreen mode

Or install globally:

npm install -g @dutchbase/img-convert
Enter fullscreen mode Exit fullscreen mode

Then run:

img-convert input.jpg output.avif
Enter fullscreen mode Exit fullscreen mode

Example usage

Convert an image:

img-convert input.png output.webp
Enter fullscreen mode Exit fullscreen mode

Convert to AVIF:

img-convert input.jpg output.avif
Enter fullscreen mode Exit fullscreen mode

Batch convert images:

img-convert ./images ./output --format webp
Enter fullscreen mode Exit fullscreen mode

Web UI mode

Sometimes you just want to convert a few images manually.

Instead of installing a separate GUI tool, you can run the Web UI locally.

This opens a simple interface where you can drop images and convert them quickly.

Designed for automation and AI workflows

One of the goals of this project was making the tool usable inside automation systems and AI agents.

Many AI workflows need to:

  • convert images
  • optimize images
  • change formats
  • prepare assets for websites

Because img-convert has predictable CLI behavior, it works well in:

  • scripts
  • CI pipelines
  • AI agents
  • local automation tools

Open source

The project is fully open source.

GitHub:
https://github.com/dutchbase/img-converter

If you find it useful, feel free to:

  • star the repo
  • open issues
  • suggest improvements
  • contribute

Feedback welcome

This project is still evolving, and I’d love feedback from people who build:

  • developer tools
  • CLI tools
  • automation systems
  • AI workflows

What features would you want in a tool like this?

Top comments (0)