ElBruno.Text2Image 0.5.3

ElBruno.Text2Image

HuggingFace ONNX Models:

📢 This project started with FLUX.2 Flex on Microsoft Foundry — a cloud-first approach to text-to-image generation with best-in-class text rendering. After wrapping that API, we thought: "Why not bring the same developer experience to local models too?" So we did. Now you can generate images from text prompts using cloud APIs or local Stable Diffusion models with ONNX Runtime — all through the same clean .NET interface.

A .NET library for text-to-image generation — cloud and local. Generate images from text prompts using Microsoft Foundry FLUX.2 or Stable Diffusion (ONNX Runtime) with automatic model downloads from HuggingFace. No Python needed. Just dotnet add package and go. 🚀

Features

• 🎨 Text-to-Image — Generate images from text prompts using Stable Diffusion or FLUX.2
• 🤖 Multiple Models — Stable Diffusion 1.5, LCM Dreamshaper, SDXL Turbo, SD 2.1, FLUX.2 (cloud)
• ⬇️ Auto-Download — ONNX models are automatically downloaded from HuggingFace on first use
• ☁️ Cloud API — FLUX.2 via Microsoft Foundry for high-quality text-heavy designs
• 🔧 ONNX Runtime — Fast, cross-platform inference (CPU, CUDA, DirectML)
• ⚡ Auto GPU Detection — Automatically uses GPU if available (CUDA → DirectML → CPU)
• 📦 NuGet Package — Simple dotnet add package installation
• 🎯 Multi-target — Supports .NET 8.0 and .NET 10.0
• 🔌 Microsoft.Extensions.AI — All generators implement IImageGenerator from Microsoft.Extensions.AI
• 🌱 Reproducible — Seed-based generation for reproducible results

Quick Start

Install

Choose the package matching your hardware:

# CPU (default — works everywhere)
dotnet add package ElBruno.Text2Image.Cpu

# NVIDIA GPU (CUDA — 4x faster)
dotnet add package ElBruno.Text2Image.Cuda

# DirectML (AMD/Intel/NVIDIA on Windows)
dotnet add package ElBruno.Text2Image.DirectML

# FLUX.2 cloud via Microsoft Foundry (no GPU needed)
dotnet add package ElBruno.Text2Image.Foundry

Note: These are mutually exclusive — install only ONE, following the same pattern as Microsoft.ML.OnnxRuntime vs Microsoft.ML.OnnxRuntime.Gpu.

Basic Usage — Local (Stable Diffusion 1.5)

using ElBruno.Text2Image;
using ElBruno.Text2Image.Models;

// Create a Stable Diffusion 1.5 generator (model downloads automatically on first use)
using var generator = new StableDiffusion15();

// Generate an image from a text prompt
var result = await generator.GenerateAsync("a beautiful sunset over a mountain lake, digital art");

// Save the generated image
await result.SaveAsync("output.png");
Console.WriteLine($"Generated in {result.InferenceTimeMs}ms (seed: {result.Seed})");

Basic Usage — Cloud (FLUX.2 via Microsoft Foundry)

using ElBruno.Text2Image;
using ElBruno.Text2Image.Foundry;

// Create a FLUX.2 generator using Microsoft Foundry
// Default model is FLUX.2-pro (photorealistic image generation)
using var generator = new Flux2Generator(
    endpoint: "https://your-resource.services.ai.azure.com",
    apiKey: "your-api-key",
    modelName: "FLUX.2 Pro",       // display name
    modelId: "FLUX.2-pro");        // deployment/model name

// Generate an image — same interface as local models
var result = await generator.GenerateAsync("a futuristic cityscape with neon lights, cyberpunk style");
await result.SaveAsync("flux2-output.png");

With Custom Options

using var generator = new StableDiffusion15();

var result = await generator.GenerateAsync("a futuristic cityscape at night, neon lights",
    new ImageGenerationOptions
    {
        NumInferenceSteps = 20,  // More steps = better quality
        GuidanceScale = 7.5,     // Higher = follows prompt more closely
        Width = 512,
        Height = 512,
        Seed = 42,               // For reproducible results
        ExecutionProvider = ExecutionProvider.Cpu
    });

await result.SaveAsync("cityscape.png");

Microsoft.Extensions.AI Interface

All generators implement Microsoft.Extensions.AI.IImageGenerator, enabling a standard API:

using Microsoft.Extensions.AI;
using ElBruno.Text2Image.Models;

// Any generator can be used via the M.E.AI interface
using var sd15 = new StableDiffusion15();
IImageGenerator generator = sd15;

var request = new ImageGenerationRequest("a whimsical treehouse in a fantasy forest");
var options = new ImageGenerationOptions
{
    ImageSize = new System.Drawing.Size(512, 512),
    AdditionalProperties = new AdditionalPropertiesDictionary
    {
        ["num_inference_steps"] = 15,
        ["guidance_scale"] = 7.5,
        ["seed"] = 42
    }
};

var response = await generator.GenerateAsync(request, options);
var imageBytes = response.Contents.OfType<DataContent>().First().Data.ToArray();
await File.WriteAllBytesAsync("output.png", imageBytes);

Custom Model Directory

// Download and use models from a specific directory
using var generator = new StableDiffusion15(new ImageGenerationOptions
{
    ModelDirectory = @"D:\MyModels",
    NumInferenceSteps = 15
});

await generator.EnsureModelAvailableAsync();
var result = await generator.GenerateAsync("a serene lake");
await result.SaveAsync("output.png");

Dependency Injection

// Local model
services.AddStableDiffusion15(options =>
{
    options.NumInferenceSteps = 20;
    options.ModelDirectory = "/path/to/models";
});

// Cloud model (requires ElBruno.Text2Image.Foundry package)
services.AddFlux2Generator(
    endpoint: "https://your-resource.openai.azure.com",
    apiKey: "your-api-key",
    modelId: "FLUX.2-pro");

// Inject IImageGenerator anywhere
public class MyService(IImageGenerator generator)
{
    public async Task<byte[]> GenerateImage(string prompt)
    {
        var result = await generator.GenerateAsync(prompt);
        return result.ImageBytes;
    }
}

Supported Models

Local Models (ONNX Runtime)

Cloud Models (REST API)

| Model | Class | Provider | Quality | Status | |-------|-------|----------|---------|--------| | FLUX.2 Pro | Flux2Generator | Microsoft Foundry | Excellent | ✅ Default | | FLUX.2 Flex | Flux2Generator | Microsoft Foundry | Excellent | ✅ Available | See docs/model-support.md for detailed model comparison.

Samples

Run a Sample

cd src/samples/scenario-01-simple
dotnet run

Documentation

• docs/architecture.md — Package structure and pipeline diagrams
• docs/gpu-acceleration.md — GPU setup (CUDA, DirectML, auto-detection)
• docs/flux2-setup-guide.md — Microsoft Foundry FLUX.2 setup
• docs/model-support.md — Detailed model comparison
• docs/onnx-conversion-guide.md — Step-by-step ONNX conversion guide
• docs/publishing.md — NuGet publishing guide (Trusted Publishing / OIDC)
• docs/security.md — Security considerations and hardening
• scripts/ — Python conversion and upload scripts

👋 About the Author

Hi! I'm ElBruno 🧡, a passionate developer and content creator exploring AI, .NET, and modern development practices.

Made with ❤️ by ElBruno

If you like this project, consider following my work across platforms:

• 📻 Podcast: No Tienen Nombre — Spanish-language episodes on AI, development, and tech culture
• 💻 Blog: ElBruno.com — Deep dives on embeddings, RAG, .NET, and local AI
• 📺 YouTube: youtube.com/elbruno — Demos, tutorials, and live coding
• 🔗 LinkedIn: @elbruno — Professional updates and insights
• 𝕏 Twitter: @elbruno — Quick tips, releases, and tech news

License

This project is licensed under the MIT License - see the LICENSE file for details.

Related Projects

• ElBruno.HuggingFace.Downloader
• ElBruno.LocalEmbeddings
• ElBruno.VibeVoiceTTS
• ElBruno.QwenTTS