# Hermes Athena image provider

Hermes backend plugin for the OpenAI-compatible image API exposed by the
Athena profile router. The router starts the local FLUX worker on demand,
unloads the active LLM and Qwen3-TTS, and restores both after generation.

## Gateway installation

Install this directory on the Hermes gateway, not on each Desktop client:

```text
$HERMES_HOME/plugins/image_gen/athena-local/
  __init__.py
  plugin.yaml
```

Set these secrets or environment variables on the gateway:

```text
ATHENA_IMAGE_BASE_URL=http://192.168.1.212:8081/v1
ATHENA_IMAGE_API_KEY=<same API key accepted by the Athena router>
```

Then enable and select the provider:

```yaml
plugins:
  enabled:
    - image_gen/athena-local

image_gen:
  provider: athena-local
  model: FLUX.2-klein-9B-fp8-beta
  max_parallel_requests: 1
```

Restart the Hermes gateway after changing plugin files or configuration. A
second computer connected to the same gateway needs no plugin installation.

Optional overrides:

- `ATHENA_IMAGE_MODEL` defaults to `FLUX.2-klein-9B-fp8-beta`.
- `ROUTER_API_KEY` is accepted as a migration fallback.
- An existing `HERMES_CUSTOM_192_168_1_212_8081_API_KEY` is accepted as the
  final fallback, so an existing Athena chat-provider setup needs no duplicate
  secret.