ElBruno.Text2Image.Cli

t2i — AI Text-to-Image CLI

Cross-platform CLI for AI text-to-image generation. This is the Lite edition — cloud providers only, no local inference.

Quick Install

dotnet tool install --global ElBruno.Text2Image.Cli

Verify installation:

t2i --version

Quick Start

First-time setup wizard:

t2i config

Generate an image:

t2i "a robot painting a landscape"

The image is saved as output.png (or a timestamped file).

Providers (Lite Edition)

This Lite edition includes cloud providers only:

Why Lite?

• Small package: ~30 MB (vs ~200 MB with local ONNX Runtime providers)
• No ONNX Runtime native libraries: Keeps installation fast and lightweight
• Cloud-first: Ideal for CI/CD, containers, and environments without local GPU

Want Local Inference?

For local CPU/GPU inference with Stable Diffusion models, see the upcoming ElBruno.Text2Image.Cli.Full package (planned for v0.2.0).

Usage

# Generate with default provider
t2i "a futuristic cityscape"

# Specify provider
t2i "a mountain landscape" --provider foundry-flux2

# Custom dimensions
t2i "abstract art" --width 1024 --height 1024

# Custom output path
t2i "a sunset" --out sunset.png

Configuration

Set up cloud providers:

# Interactive setup
t2i secrets set foundry-flux2

# Environment variables
export T2I_FOUNDRY_FLUX2_ENDPOINT="https://your-resource.services.ai.azure.com"
export T2I_FOUNDRY_FLUX2_APIKEY="your-api-key"

List available providers:

t2i providers

Run diagnostics:

t2i doctor

Initialize AI agent skill file:

t2i init

This creates .github/skills/t2i/SKILL.md and .claude/skills/t2i/SKILL.md in your repository so AI coding agents (GitHub Copilot, Claude Code) automatically know how to use the t2i CLI.

Documentation

Full documentation: docs/cli-tool.md

Repository: github.com/elbruno/ElBruno.Text2Image

License

MIT — see LICENSE