Microsoft Foundry MAI image generation

From its catalog listing

Microsoft Foundry MAI text-to-image generation and image editing with up to five reference images as a Hermes image_gen provider (image_gen.provider: azure-mai). Maps Hermes aspect ratios onto MAI width/height presets and exposes the resource's own model list.

Good to know before installing

sends your prompt, the optional source images and your MAI_FOUNDRY_API_KEY (read per request through Hermes secret scope for the active profile) over https to your own Azure AI Foundry resource; with the opt-in web_grounding option (MAI-Image-2.6, off by default) the service may send prompt-derived search queries to Bing; every generation bills your Foundry subscription with no Hermes approval prompt before spending. Results are downloaded into the Hermes image cache under $HERMES_HOME/cache/images/. No telemetry, shell commands, background processes, self-updates or extra Python dependencies beyond requests.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs (this one needs MAI_FOUNDRY_API_KEY, MAI_FOUNDRY_ENDPOINT), then asks whether to turn it on.
    hermes plugins install azure-mai-image
  2. Said no? Turn it on later:
    hermes plugins enable azure-mai-image
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Images, video, music & 3D · AI models & providers
Maintained by
joescars (Community)
Needs
MAI_FOUNDRY_API_KEY MAI_FOUNDRY_ENDPOINT API keys
Needs Hermes
0.21.6 or newer
Version
0.2.1
In the catalog
2026-11-17

Known issues (from its catalog listing)

  • The endpoint must be the Foundry *resource root* (for example https://your-resource.services.ai.azure.com); the provider appends /mai/v1 itself and rejects pasted /mai/v1 paths.
  • Model discovery uses the resource's /models route, which not every Foundry resource exposes; when it is absent or empty the built-in MAI fallback catalog is used. Override the discovery path with MAI_FOUNDRY_MODELS_PATH.
  • Editing accepts up to five JPEG/PNG source images (local paths or http(s) URLs); requests with more than five are rejected before any request is sent.
  • Source images must be JPEG or PNG; GIF and WebP sources are rejected before upload with error_type invalid_input (no conversion is performed).
  • provider.py imports agent.file_safety.raise_if_read_blocked to vet local source-image paths. The manifest validator reports it as a private core import (catalog rule 9); it may need updating on a Hermes release.
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in images, video, music & 3d

All images, video, music & 3d plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins