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
- 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 - Said no? Turn it on later:
hermes plugins enable azure-mai-image - 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_KEYMAI_FOUNDRY_ENDPOINTAPI 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

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