Metadata-Version: 2.5
Name: genimg
Version: 0.1.0
Summary: Multi-provider image generation CLI (Gemini + OpenAI)
Project-URL: Homepage, https://github.com/lucharo/genimg
Project-URL: Documentation, https://genimg.luischav.es/
Project-URL: Source, https://github.com/lucharo/genimg
Project-URL: Issues, https://github.com/lucharo/genimg/issues
License-Expression: MIT
License-File: LICENSE
License-File: skills/genimg-infographic/LICENSE
Requires-Python: >=3.11
Requires-Dist: c2pa-python<0.38,>=0.37.10
Requires-Dist: click>=8.1
Requires-Dist: google-genai>=1.51
Requires-Dist: httpx>=0.27
Requires-Dist: openai>=1.50
Requires-Dist: pillow>=10
Requires-Dist: pydantic>=2.7
Requires-Dist: questionary>=2.0
Requires-Dist: rich>=13
Requires-Dist: textual-image[textual]<0.14,>=0.13.2; python_full_version >= '3.12'
Requires-Dist: textual<9,>=8
Requires-Dist: tomli-w>=1.0
Requires-Dist: typer<0.26,>=0.12
Description-Content-Type: text/markdown

# genimg

[![CI](https://img.shields.io/github/actions/workflow/status/lucharo/genimg/ci.yml?branch=main&label=CI)](https://github.com/lucharo/genimg/actions/workflows/ci.yml)
[![Python 3.11 to 3.14](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](pyproject.toml)
[![PyPI](https://img.shields.io/pypi/v/genimg)](https://pypi.org/project/genimg/)
[![Licence: MIT](https://img.shields.io/badge/licence-MIT-green)](LICENSE)

- One command for OpenAI and Google DeepMind [image models](https://genimg.luischav.es/reference/models/), on an API
  key or your [ChatGPT subscription through Codex](https://genimg.luischav.es/guide/codex-subscription/).
- Variations that actually differ, side by side in an [HTML grid](https://genimg.luischav.es/visual-tools/grid/), and a
  [drawing studio](https://genimg.luischav.es/visual-tools/draw-studio/) to sketch what you mean.
- [Skills](https://genimg.luischav.es/skills/) so your coding agent can do all of it.

Made for humans and agents; the agent-native design is inspired by [kenn-io](https://github.com/kenn-io)'s
[roborev](https://github.com/kenn-io/roborev) and [agentsview](https://github.com/kenn-io/agentsview).

**Docs: [genimg.luischav.es](https://genimg.luischav.es/)**

```bash
uv tool install genimg
genimg setup                      # connect a provider and save a profile
genimg "a minimal fox logo, NOT a grid" \
  --model oai:gi2.5-flare \
  --num 4 \
  --deltas "line art, block print, brush stroke" \
  --output fox.png \
  --grid \
  --open
```

![The HTML grid genimg opened: four fox logos labelled base prompt, line art, block print and brush stroke](docs/assets/grid.webp)

Add the skills to Claude Code, Codex, Cursor or OpenCode with `npx skills add lucharo/genimg`:
`genimg` plus workflows for infographics, visual exploration, visual review and image-to-app.
Pick some with `--skill`, e.g. `npx skills add lucharo/genimg --skill genimg genimg-infographic`.

## Docs

- [Getting started](https://genimg.luischav.es/getting-started/): install, providers, first image
- [For agents](https://genimg.luischav.es/agents/): the skills and what an agent can read
- [Guide](https://genimg.luischav.es/guide/diversity/): diverse images, input images, Codex
- [Reference](https://genimg.luischav.es/reference/cli/): CLI, models, config.toml

## Contributing

`uv sync`, then `uv run pytest` and `uv run ruff check .`. See [CONTRIBUTING.md](CONTRIBUTING.md)
and the [maintainer docs](https://genimg.luischav.es/maintainers/).
