dashscope-image

hermes-plugin-dashscope-image

Image generation plugin for Hermes Agent using Alibaba Cloud DashScope (Qwen Cloud).

Brings Alibaba's Wan 2.7 image models to Hermes's image_generate tool. Works with both token plan keys (sk-sp-*) and pay-as-you-go keys (sk-ws-*).

Example

Image-to-image generation with wan2.7-image-pro -- anime character placed into a cyberpunk cityscape with Qwen neon signage:

Cyberpunk Qwen

Models

| Model | Strengths |
|-------|-----------|
| wan2.7-image | Fast text-to-image (~5s) |
| wan2.7-image-pro | Higher fidelity, image-to-image editing (~10s) |

Both models are included in the Alibaba Cloud AI Token Plan subscription and are available on the PAYG free tier.

Install

hermes plugins install rriggs/hermes-plugin-dashscope-image
hermes plugins enable dashscope

Configure

All configuration lives under image_gen.dashscope in config.yaml:

image_gen:
  provider: dashscope
  dashscope:
    api: https://token-plan.ap-southeast-1.maas.aliyuncs.com
    key_env: QWEN_API_KEY
    model: wan2.7-image          # optional

| Key | Default | Description |
|-----|---------|-------------|
| api | https://token-plan.ap-southeast-1.maas.aliyuncs.com | DashScope API base URL |
| key_env | QWEN_API_KEY | Name of the env var holding your API key |
| model | wan2.7-image | Default model for generation |

Set the API key in your .env file:

QWEN_API_KEY=***

PAYG users

image_gen:
  provider: dashscope
  dashscope:
    api: https://dashscope-intl.aliyuncs.com
    key_env: DASHSCOPE_API_KEY

No env var names are hard-coded -- key_env tells the plugin which env var to read.

Usage

Once configured, Hermes's image_generate tool routes through DashScope automatically:

Text-to-image: just provide a prompt
Image-to-image: provide image_url (auto-upgrades to wan2.7-image-pro)
- Accepts URLs (https://...), data URIs (data:image/png;base64,...), or local file paths (/path/to/image.png) -- local files are automatically base64-encoded inline

Generated images are cached locally under $HERMES_HOME/cache/images/ since DashScope OSS URLs expire after ~24 hours.

API Details

This plugin uses the native DashScope multimodal-generation API:

POST {api}/api/v1/services/aigc/multimodal-generation/generation

The OpenAI-compatible /images/generations endpoint is NOT used because the token plan endpoint does not serve image models on that path.

Requirements

Hermes Agent v0.18+
API key set in the env var named by key_env
requests Python package (bundled with Hermes)

License

MIT

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