kestrel-feature-visual

Visual identity for Kestrel Sovereign agents — avatar generation, selfies, and LoRA training for character consistency. Uses Replicate for image generation with optional LoRA training for consistent visual identity across generated images.

Installation

uv pip install kestrel-feature-visual

The feature is auto-discovered by Kestrel Sovereign via the kestrel_sovereign.features entry point — install it alongside kestrel-sovereign and the VisualIdentityFeature registers itself at startup.

Configuration

Variable	Description
`REPLICATE_API_TOKEN`	Replicate API token for image generation (required for avatar/selfie tools)

Tools provided

generate_avatar — Create a portrait avatar from a description
generate_selfie — Generate a selfie in various scenes (casual, portrait, glamour, flirty, cozy, adventure, mysterious, romantic, playful, dreamy, confident)
train_lora — Kick off LoRA training for character consistency (requires kestrel-feature-lora or another training provider installed alongside)

Dependencies

kestrel-sovereign-sdk>=0.14.1,<1 — base Feature, tool, and ToolCategory interfaces
replicate>=1.0.4 — Replicate API client
httpx>=0.27.0 — HTTP transport

Development

uv pip install -e '.[test]'
uv run pytest

License

Apache-2.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kestrel_feature_visual-0.3.1.tar.gz (39.0 kB view details)

Uploaded Jul 15, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

kestrel_feature_visual-0.3.1-py3-none-any.whl (41.4 kB view details)

Uploaded Jul 15, 2026 Python 3

File details

Details for the file kestrel_feature_visual-0.3.1.tar.gz.

File metadata

Download URL: kestrel_feature_visual-0.3.1.tar.gz
Upload date: Jul 15, 2026
Size: 39.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for kestrel_feature_visual-0.3.1.tar.gz
Algorithm	Hash digest
SHA256	`9fc5fd6aa8c1d91c46e07f81c8fc88856f48548d557d0d25a9f87e1a33d17c1d`
MD5	`780d06344425d5adde6e3f0a24364ce7`
BLAKE2b-256	`fcd7a7b106a15eb80f675ef57c63d30886ac0f97ba062206f25223c4c65d8ad9`

See more details on using hashes here.

Provenance

The following attestation bundles were made for kestrel_feature_visual-0.3.1.tar.gz:

Publisher: publish.yml on KestrelSovereignAI/kestrel-feature-visual

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: kestrel_feature_visual-0.3.1.tar.gz
- Subject digest: 9fc5fd6aa8c1d91c46e07f81c8fc88856f48548d557d0d25a9f87e1a33d17c1d
- Sigstore transparency entry: 2173741064
- Sigstore integration time: Jul 15, 2026
Source repository:
- Permalink: KestrelSovereignAI/kestrel-feature-visual@f6a79439caa6c4b3de5d42e51ba9a77fe6bae3dc
- Branch / Tag: refs/tags/v0.3.1
- Owner: https://github.com/KestrelSovereignAI
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@f6a79439caa6c4b3de5d42e51ba9a77fe6bae3dc
- Trigger Event: push