kiarina-agi-image 2.8.0

Image detection, embedding, and generation for AI agents

kiarina-agi-image

English | 日本語

[!NOTE] What is this? kiarina-agi-image provides image detection, embedding, and generation for AI agents.

Dependencies

Required Dependencies

Package	Version	License
kiarina-agi-base	>=2.7.0	MIT
kiarina-agi-data	>=2.7.0	MIT
kiarina-agi-file	>=2.6.0	MIT
kiarina-utils-app	>=2.4.0	MIT
kiarina-utils-common	>=2.3.0	MIT
kiarina-utils-file	>=2.3.1	MIT
NumPy	>=2.0,<3	BSD-3-Clause
OpenCV	>=4.12.0,<5	Apache-2.0
Pillow	>=11.3.0,<12	HPND
Pydantic	>=2.11.7,<3	MIT
pydantic-settings	>=2.10.1,<3	MIT
pydantic-settings-manager	>=3.2.0	MIT

Optional Dependencies

Package	Extras
google-genai	image-embedding-provider-gemini image-generation-provider-google
httpx	image-embedding-provider-qwen3-vl image-generation-provider-openai
kiarina-lib-google	image-embedding-provider-gemini image-generation-provider-google
kiarina-lib-openai	image-generation-provider-openai
onnxruntime	image-detection-provider-dfine image-embedding-provider-siglip2
openai	image-generation-provider-openai

The all Extra installs every optional dependency listed above.

Installation

pip install kiarina-agi-image

To use every provider implementation:

pip install "kiarina-agi-image[all]"

Features

• Image Detection Detect objects and faces, crop objects, and align faces.
• Image Embedding Create image embeddings.
• Image Generation Generate and edit images with Google, OpenAI, and mock providers.

Model Cache

YuNet, D-FINE, SFace, and SigLIP2 download their default model on first use when model_path is None. D-FINE also downloads a verified config.json and generates default labels from it when label_map_path is None.

Files are cached under user_directory.get_user_cache_dir() / "models" / <implementation>. An explicit path always takes precedence and prevents downloading the corresponding file.

The default download URL, SHA-256 digest, and cache filename are provider settings and can be overridden through settings, environment variables, or config. When changing the source, also change the filename if an existing cached file should not be reused.

API Reference

kiarina.agi.image_detection_model

Exports image detection model settings, registries, detection helpers, and cropping helpers.

kiarina.agi.image_detection_provider

Exports the image detection provider protocol, base class, detection result view, and registry.

kiarina.agi.image_embedding_model

Exports image embedding model settings, registry, and embedding helper.

kiarina.agi.image_embedding_provider

Exports the image embedding provider protocol, base class, and registry.

kiarina.agi.image_generation_model

Exports image generation model settings, registry, and generation helper.

kiarina.agi.image_generation_provider

Exports the image generation provider protocol, base class, result view, and registry.

Import provider implementations from the matching kiarina.agi.*_provider_impl.<name> path.