All plugins

wiro-media

Wiro AI's image, video, speech, music, transcription and 3D models as thirteen wiro_* tools: generate and edit images (upscale, remove backgrounds, prompt edits), text or image to video, text to speech, music, transcription, image to 3D, catalog search with prices, any catalog model, task follow-up and Wiro AI workflows. It also registers Wiro AI as an opt-in backend for image_generate, video_generate, text_to_speech and speech-to-text, and ships the wiro-media:wiro skill. Every tool takes any catalog model; outputs are saved in cache/generated/ with MEDIA: tags, and every result reports its cost. Disclosure — prompts, settings and input files go to https://api.wiro.ai/v1 with WIRO_API_KEY, read per call through Hermes secret scope; every generation spends the user's Wiro AI balance with no Hermes approval prompt, and the model can pick costly options such as high resolution or long video. Local input files are read only from Hermes' media cache, or from anywhere the user can read when the terminal backend is local (system and credential folders and the rest of the Hermes home excluded), and only when their bytes are media or documents of the expected kind; they are uploaded to the user's Wiro AI storage. Output files are downloaded only from *.wiro.ai hosts. Ogg Opus voice notes and bmp, tiff or avif images are converted with the local ffmpeg when it is installed.

wiroaiToolsv2.0.0Updated 7 days ago

About

Wiro AI's image, video, speech, music, transcription and 3D models as thirteen wiro_* tools: generate and edit images (upscale, remove backgrounds, prompt edits), text or image to video, text to speech, music, transcription, image to 3D, catalog search with prices, any catalog model, task follow-up and Wiro AI workflows. It also registers Wiro AI as an opt-in backend for image_generate, video_generate, text_to_speech and speech-to-text, and ships the wiro-media:wiro skill. Every tool takes any catalog model; outputs are saved in cache/generated/ with MEDIA: tags, and every result reports its cost. Disclosure — prompts, settings and input files go to https://api.wiro.ai/v1 with WIRO_API_KEY, read per call through Hermes secret scope; every generation spends the user's Wiro AI balance with no Hermes approval prompt, and the model can pick costly options such as high resolution or long video. Local input files are read only from Hermes' media cache, or from anywhere the user can read when the terminal backend is local (system and credential folders and the rest of the Hermes home excluded), and only when their bytes are media or documents of the expected kind; they are uploaded to the user's Wiro AI storage. Output files are downloaded only from *.wiro.ai hosts. Ogg Opus voice notes and bmp, tiff or avif images are converted with the local ffmpeg when it is installed.

Wiro AI media tools for Hermes

Make and edit images, video, speech, music, transcripts and 3D models in
Hermes Agent with Wiro AI's
catalog of 1,000+ models, all on one API key. The plugin adds thirteen wiro_* tools, a skill
with ready recipes, and Wiro AI as a backend for Hermes' own image_generate, video_generate,
text_to_speech and voice message transcription. Requires Hermes 0.22.6 or later. It has no
Python dependencies.

Connect

hermes plugins install wiro-media --enable
hermes config set WIRO_API_KEY <your-key>

Until the catalog listing lands, install from the repository:
hermes plugins install "https://github.com/wiroai/Wiro-Hermes#wiro-media" --enable.

Create the key under your project at wiro.ai/panel/project. For a
Signature project, the value is YOUR_API_KEY:YOUR_API_SECRET. The same key works for the
wiro model provider plugin, so Hermes can chat through Wiro AI's LLM
gateway too.

Then ask for what you want: "make a poster of a lighthouse", "remove the background of this
photo", "turn this picture into a five second clip", "transcribe this voice note".

Hermes makes a mug photo with wiro_generate_image and reports the cost, next to the saved image

Tools

ToolWhat it does
wiro_generate_imageImages from a prompt, optionally guided by reference images. Aspect ratio, resolution, count, seed.
wiro_edit_imageChange a picture with a prompt (objects, style, background, text, combining images), upscale it, or remove_background.
wiro_generate_videoVideo from a prompt, or from a start image (and an end frame where the model takes one). Duration, aspect ratio, resolution, sound.
wiro_text_to_speechRead text aloud in a chosen voice and language.
wiro_generate_musicInstrumental tracks, or songs from lyrics.
wiro_transcribeSpeech to text from voice notes, recordings or the sound of a video.
wiro_generate_3dA 3D model (GLB) from a picture of an object.
wiro_search_modelsSearch the catalog by key words or category; every row has its price.
wiro_model_infoOne model's parameters, options, defaults and full price table.
wiro_run_modelRun any model with its own parameters: lip sync, try-on, voice cloning, video to video, LLMs and more.
wiro_taskWait for a task that was still running and save its files, check it, stop it, or list recent tasks with their cost.
wiro_workflowsFind your Wiro AI workflows (or the public gallery) and read their inputs.
wiro_run_workflowRun a workflow and save its outputs.

The tools live in the wiro toolset, which hermes tools can switch on or off per platform.

Models

Every media tool takes any model ID in its model argument. Without one it uses a default, and
each default can be changed in the plugin settings:

SettingDefault
image_modelgoogle/nano-banana-2-1
edit_modelgoogle/nano-banana-2-1
upscale_modelxinntao/real-esrgan
background_modelwiro/remove-background
video_modelbytedance/seedance-v1-pro-fast
speech_modelelevenlabs/eleven-v4-turbo
music_modelelevenlabs/text-to-music-v2
transcribe_modelelevenlabs/speech-to-text
model3d_modelmicrosoft/trellis-2
wait_seconds240
hermes config set plugins.entries.wiro-media.settings.video_model klingai/kling-v4-flash

A tool fills the model's own parameters from its arguments: the prompt, input files, aspect
ratio (the nearest one the model offers), duration (the nearest length it offers), resolution,
voice and the rest. Settings an argument does not cover go in params, keyed by the parameter
ids wiro_model_info lists. Required settings left out get the model's catalog default, and the
result says which.

Files

Inputs take a public URL or a local path. Local files are uploaded to your Wiro AI storage first:
files sent in a chat (they sit in Hermes' media cache), results of earlier wiro_* calls, and,
when the terminal backend is local, files in your workspace (a relative path is read from the
session's folder). A file is uploaded only when its bytes are the kind of media the argument
takes. System folders, credential folders such as ~/.ssh and ~/.config, and the Hermes home
outside its media caches are never read. With a sandboxed terminal backend (Docker, SSH, Modal
and the like), only files in Hermes' media cache are read. Voice notes in Ogg Opus (Telegram,
WhatsApp) and bmp, tiff or avif images are converted to m4a or png with your local ffmpeg
before the upload, when ffmpeg is installed.

Hermes transcribes a voice note with wiro_transcribe and answers out loud with wiro_text_to_speech

Outputs are saved in Hermes' media cache, the folder and naming Hermes' own image and video
providers use:

~/.hermes/cache/generated/images/wiro_20261111_185327_a62fdd6d.jpg
~/.hermes/cache/generated/videos/   ~/.hermes/cache/generated/audio/
~/.hermes/cache/generated/3d/       ~/.hermes/cache/generated/files/

Each result lists the files with their path, Wiro AI URL and type, plus a media_tag line
(MEDIA:/path) per file, which delivers the file as an attachment on messaging platforms and in
the desktop app. Transcripts and LLM answers come back as text.

Long jobs

A tool waits up to wait_seconds (240 by default, at most 360, inside Hermes' tool time limit).
A task still running then keeps going on Wiro AI: the result carries its task_token, and
wiro_task waits for it and saves the files without starting a second run.

Skill

skill_view("wiro-media:wiro") loads the plugin's skill: which tool fits a job, how to pick a
model and read its price, file handling, long jobs, and recipes such as product photo to ad clip,
idea to 3D asset, and voice note to spoken answer.

Hermes' own media tools on Wiro AI

The plugin also registers Wiro AI as a backend for four of Hermes' built-in features. Each is off
until you choose it, in hermes tools or in config.yaml:

image_gen:
  provider: wiro
  model: google/nano-banana-2-1        # any Wiro AI image model
video_gen:
  provider: wiro
  model: bytedance/seedance-v1-pro-fast
tts:
  provider: wiro
  model: elevenlabs/eleven-v4-turbo
  voice: brian
stt:
  provider: wiro
  wiro:
    model: elevenlabs/speech-to-text

image_generate and video_generate then run on Wiro AI, text_to_speech speaks with a Wiro AI
voice (as a voice bubble on platforms that have them), and voice messages sent to the gateway
are transcribed by a Wiro AI model.

Pricing

Runs are paid as you go from your Wiro AI wallet, at each model's own price: per run, per output,
per second or per character, as the model's page shows. wiro_search_models and
wiro_model_info show prices before a run, every result reports what the run cost, and
wiro_task with action: "list" shows recent tasks with their cost. Failed tasks are not
charged. Searching, reading models and workflows, and checking tasks are free. Prices are on
wiro.ai/models.

Scope

  • Network: requests go to https://api.wiro.ai/v1 with the key Hermes reads
    (WIRO_API_KEY, through Hermes' secret scope): prompts, settings, and input files you pass.
    Output files are downloaded only from Wiro AI hosts (*.wiro.ai). No other host is contacted.
  • Spending: every generation spends your Wiro AI balance without a Hermes approval prompt;
    the model can choose costly options (high resolution, long video) when asked to.
  • Files: reads the local input files described above, writes outputs under
    cache/generated/ in your Hermes home, and runs ffmpeg to convert audio or images in the
    formats above when it is installed.
  • Nothing else: no hooks, middleware, background work, telemetry or self-update. Update it
    with hermes plugins update wiro-media.

MIT license.

README from the reviewed commit be81dea; it updates when the author re-pins.

More by wiroai

2 plugins by wiroai in the catalog.

Developer Mode

Explore built-in Hermes toolsets and actions.

HermesAgent

Developer?

Create a Hermes extension for Desktop or agent workflows.

Developer Section