CryptoPatrick / agents
Portrait of agenticon, Agent Agenticon #11 of 23

Agents/Uncategorized

Agent Available v0.2.0

agenticon

Agent Agenticon

agenticon is a library built around custom generation of identicon images for AI agents.

Get started Docs crates.io GitHub

Portrait pending: this agent's prompt is in agents/prompts.md. Its colour is a stand-in until the portrait arrives.

20Downloads, all time
20Last 90 days
2Releases since Oct 2026

Downloads per day

Last 90 days · 20 total · peak 18

Dossier

What agenticon does.

agenticon is a library built around custom generation of identicon images for AI agents.

From the crate: “agenticon is a library built around custom generation of identicon images for AI agents.”

Codename
Agent Agenticon
Role
Agent
Character
Quiet, exact, and new here.
Domain
Uncategorized
Enlisted
27 October 2026
Last release
v0.2.0, 27 October 2026
Keywords
agent, avatar, generative, identicon, sound

Getting started

Call it in.

Add it to a Rust project, then follow the example. The full API is on docs.rs.

Install

cargo add agenticon

Example

use agenticon::{AgentId, Agenticon};

let icon = Agenticon::new("1234-5678-9012".parse::<AgentId>()?);
icon.save_all("out", 512)?; // out/1234-5678-9012-3d.png, -flat.png, .wav

Build with a prompt

Add the Rust crate `agenticon` (version 0.2.0) to this project with `cargo add agenticon`. I want to use it for this: agenticon is a library built around custom generation of identicon images for AI agents. Before writing code, read its README at https://crates.io/crates/agenticon and the API docs at https://docs.rs/agenticon. Use only the functions, types and signatures that appear there; do not invent API names. Write a minimal working example and one test that runs it.

Paste this into Claude Code or another coding agent.

Specs

Version
0.2.0
License
AGPL-3.0-only
Edition
Rust 2024
MSRV
1.87
Size
1,461 lines of code, 5 of comments
Package
38.3 KB compressed
Dependencies
sha2, tiny-skia
Used by
0 crates on crates.io
Docs
docs.rs, built
Repository
cryptopatrick/agenticon · 0★ · 0 forks · 0 open issues · pushed 27 Oct 2026

Release history

VersionDateDownloads
0.2.027 Oct 202610
0.1.027 Oct 202610

Documentation

The manual.

The crate's README as published on crates.io. The full API reference is on docs.rs.

Read the README

agenticon

agenticon is a library built around custom generation of identicon images for AI agents.

Overview

Every agent gets an ID in [0, 10^12) (shown as XXXX-XXXX-XXXX). A keyed bijective permutation turns the ID into a 40-bit genome (2^40 > 10^12), and every bit sets a trait. So no two IDs share an agenticon, and IDs n and n+1 look and sound unrelated.

Key Features

  • 3D view: a shaded perspective view of a prism, antiprism, bipyramid or frustum (3–10 sides), with its own rotation, tilt, height, palette and 20-segment orbit ring.
  • Flat view: the same solid flattened along its axis (orthographic, unlit). It carries all 40 bits too.
  • Sound: a ~2 s FM jingle (root, tempo, instrument, rhythm, 7 notes = 40 bits).
  • Minting: derive IDs from a Bitcoin/Ethereum block hash + minter + nonce (SHA-256). A Registry re-rolls the nonce on collision, since no hash alone can guarantee uniqueness.

Architecture

Quick Start

use agenticon::{AgentId, Agenticon};

let icon = Agenticon::new("1234-5678-9012".parse::<AgentId>()?);
icon.save_all("out", 512)?; // out/1234-5678-9012-3d.png, -flat.png, .wav

Documentation

Examples

cargo run --example basic -- 1234-5678-9012
cargo run --example gallery
cargo run --release --example uniqueness -- 30000 48
H=$(curl -s https://mempool.space/api/blocks/tip/height)
B=$(curl -s https://mempool.space/api/blocks/tip/hash)
cargo run --example mint -- bitcoin $H $B alice bob

Contributing

Contributions are welcome! Please see our contributing guidelines for details on:

  • Code style and testing requirements
  • Submitting bug reports and feature requests
  • Development setup and workflow

License

This project is licensed under the GNU Affero General Public License v3.0 only (AGPL-3.0-only). See LICENSE for details.

Resources

Same unit

Other agents.