# ImaGen

Model-agnostic image-generation framework: pluggable backends (local FLUX on
mRock, Replicate, DALL-E, …) behind a single CLI / skill / API.

```
imagen generate "a cat in a fishbowl" --backend flux-schnell-local --size 1024x1024
```

See [`CLAUDE.md`](./CLAUDE.md) for the design — backend contract, registry,
config layout, how to add a new adapter.

## Install

```sh
go install mgit.msbls.de/m/ImaGen/cmd/imagen@latest
```

Or from a checkout:

```sh
make build       # writes ./bin/imagen
make install     # installs into $GOBIN (defaults to ~/go/bin)
```

## First run

```sh
mkdir -p ~/.config
imagen config init > ~/.config/imagen.yaml
imagen config validate
imagen backends
imagen generate "test prompt" --backend mock --output /tmp/x.png
```

The mock backend ships in this repo and produces a deterministic gradient
PNG — useful for smoke-testing the pipeline without reaching any model.

## Status

| Component               | Status        |
| ----------------------- | ------------- |
| Backend interface       | done (#1)     |
| Mock backend            | done (#1)     |
| ComfyUI / FLUX on mRock | open (#2)     |
| Replicate adapter       | open (#3)     |
| `/imagine` skill        | open (#4)     |
| HTTP server             | stubbed (#1)  |

Issues live at <https://mgit.msbls.de/m/ImaGen/issues>.