Fuuga.Image 1.0.4

Fuuga.Image

This is image generation MCP client for Fuuga (or other agents) to make the agent capable of producing images via other (Stable Diffusion) models from for example HuggingFace.

Standalone CLI tool for image generation and captioning, built on stable-diffusion.cpp and Phi-3.5-vision.

Commands

fuuga-image txt2img   Generate an image from a text prompt
fuuga-image img2img   Transform an image guided by a text prompt
fuuga-image caption   Generate a text description of an image
fuuga-image info      Display model metadata

Quick Start

dotnet build

# Text-to-image
dotnet run -- txt2img --model path/to/model.ckpt --prompt "a cat sitting on a windowsill" --steps 20

# Image-to-image
dotnet run -- img2img --model path/to/model.ckpt --source input.png --prompt "in watercolor style" --strength 0.75

# Caption an image
dotnet run -- caption --model path/to/phi-3.5-vision/ --image photo.jpg --detail standard

# Model info
dotnet run -- info --model path/to/model.ckpt

Common Options

txt2img Options

img2img Options

Same as txt2img, plus:

caption Options

MCP Server Mode

Fuuga.Image can run as an MCP tool server over stdio, enabling integration with Fuuga LLM via the MCP protocol:

dotnet run -- --mcp-server

This exposes three tools via JSON-RPC 2.0 over stdin/stdout:

• fuuga_image_txt2img -- text-to-image generation
• fuuga_image_img2img -- image-to-image transformation
• fuuga_image_caption -- image captioning

See architecture.md Section 18 for the full integration design.

F# Script Demo

An interactive demo script shows how to use Fuuga.Image as an F# library — calling the modules directly with record-based configuration, validation, and I/O:

dotnet build Fuuga.Image
dotnet fsi examples/image-demo.fsx

The script runs without models (dry-run mode), exercising types, validation, image I/O, and prompt templates. Uncomment Section 5 and set your model paths for actual generation. See examples/image-demo.fsx for the full source.

Project Structure

Fuuga.Image/
  Types.fs        Layer 0: Domain types, error handling (ImageError DU)
  Config.fs       Layer 1: CLI argument parsing
  ImageIO.fs      Layer 2: Image load/save, format conversion, validation
  Diffusion.fs    Layer 3: Stable Diffusion model wrapper (txt2img, img2img)
  Caption.fs      Layer 4: Phi-3.5-vision captioning (ONNX Runtime GenAI)
  McpServer.fs    Layer 5: MCP JSON-RPC 2.0 server over stdio
  Program.fs      Layer 6: Entry point, subcommand routing, error handling

Architecture

• Image Extension Architecture -- standalone design
• Main Architecture Section 18 -- Fuuga LLM integration