v0.3.2 — PyPI Metadata & Package Page

What's New

PyPI Package Page

• Added full project description, keywords, and classifiers
• Added project URLs (homepage, docs, repository, changelog)
• Package page now shows proper metadata at pypi.org/project/youam

Bug Fix

• Fixed dependencies being incorrectly nested under [project.urls] (see PR #20)

Install

pip install youam==0.3.2

Full Changelog: v0.3.1...v0.3.2

v0.3.1 — Relay dependency fix

What's Changed

Moves relay dependencies (fastapi, uvicorn, sqlmodel, sqlalchemy, asyncpg, alembic) from optional extras into base dependencies. This ensures pip install youam includes everything needed to run a relay server without requiring pip install youam[relay].

Install

pip install youam==0.3.1

Full Changelog: v0.3.0...v0.3.1

v0.3.0 — Relay v3.0: PostgreSQL, SQLModel, Full CRUD

What's New

This is a major relay infrastructure upgrade. The SDK and protocol layers are unchanged — this release is fully backwards-compatible for agents using pip install youam.

Relay v3.0: PostgreSQL + SQLModel

The relay server has been completely rewritten from raw aiosqlite to a proper database layer:

• PostgreSQL support — Relays can now run on PostgreSQL (via asyncpg) for production deployments, with SQLite fallback for development
• SQLModel ORM — All database access goes through typed SQLModel models instead of raw SQL strings
• Full CRUD layer — 12 domain-specific CRUD modules (uam.db.crud.*) covering agents, messages, contacts, federation, reputation, spam, webhooks, handshakes, dedup, audit, and domain verification
• Alembic migrations — Schema changes are now managed via Alembic with automatic migration on startup
• Session management — Proper async session handling with get_session() dependency injection
• Retry logic — Database operations include configurable retry with exponential backoff for transient failures

Other Changes

• Docs fix — pip install uam corrected to pip install youam in quickstart and index
• New optional dependency groups — pip install youam[db] and pip install youam[relay] now pull in PostgreSQL/SQLModel dependencies

For Relay Operators

If you run a UAM relay, this release changes your database layer. Key notes:

• Existing SQLite relays will continue to work — Alembic auto-migrates on startup
• To use PostgreSQL, set DATABASE_URL=postgresql+asyncpg://user:pass@host/db
• See updated Operator Guide for configuration

Install

pip install youam==0.3.0

# For relay operators:
pip install youam[relay]==0.3.0

Full Changelog: v0.2.5...v0.3.0

v0.2.5

Fixes

• Relay: Fix fresh install crash (additional DB init fixes beyond v0.2.4)
• SDK: Contact book improvements

Install

pip install youam==0.2.5

v0.2.4

Fixes

• Relay: Fix crash loop on fresh database — schema now runs before migrations
• PyPI: Add Python 3.10-3.13 classifiers (fixes "missing" badge)

TypeScript SDK

• @youam/sdk 0.2.0 published to npm — full SDK with E2E encryption, TOFU key pinning, contact book, CLI, DNS verification

Install

pip install youam        # Python
npm install @youam/sdk   # TypeScript

v0.2.3

Fixes

• save_token mkdir — ensures ~/.uam/keys/ directory exists before writing relay token, fixing a crash when bootstrapping via UAM_SIGNING_KEY env var (which skips directory creation)

Install

pip install youam

v0.2.2

New Features

• UAM_SIGNING_KEY env var — provide a base64-encoded Ed25519 seed via environment variable, skipping file I/O entirely
• UAM_TOKEN env var — provide relay auth token via environment variable

Enables ephemeral/containerized deployments where agents bootstrap without a persistent ~/.uam/keys/ directory. Env vars take precedence over file-based storage; file fallback is preserved.

Install

pip install youam

v0.2.1

Patch release fixing an import crash when web3 is not installed.

Fixes

• Bundle ABI as package data — UAMNameRegistry.abi.json is now included in the wheel so Tier 3 resolution works without the contracts directory
• Lazy-load Tier3Resolver — avoids ImportError when web3 optional dependency is not installed
• Relay database migrations v9/v10 — handles api_key → token column rename for existing relay databases

Install

pip install youam

v0.2.0

New Features

• TOFU key pinning — Trust On First Use, SSH-style. After first handshake, public keys are pinned locally. Any future key mismatch raises a hard KeyPinningError. Closes the Tier 1 relay MITM vector.
• TypeScript SDK — full implementation with CLI, protocol layer, and cross-language interop tests
• Solidity smart contracts — UAMNameRegistry and UAMPriceOracle for Tier 3 on-chain namespaces
• A2A bridge — Google A2A protocol adapter
• OpenClaw plugin — native messaging channel for OpenClaw-compatible agents
• Relay federation — cross-relay message routing and discovery
• Relay reputation & blocklist — reputation scoring and domain/address blocking
• Docker deployment — docker-compose for self-hosted relay setup
• Relay operator docs — configuration, federation setup, and operator guide

New CLI Commands

• uam contact fingerprint — show contact key fingerprints
• uam contact verify <addr> — verify a contact's key
• uam contact remove <addr> — remove a contact

New Trust Policy

• require-verify — only accept messages from verified contacts (strictest mode)

Install

pip install youam

Links

• Docs: https://docs.youam.network
• Website: https://youam.network
• PyPI: https://pypi.org/project/youam/

v0.1.0 — Initial Release

First public release of the Universal Agent Messaging protocol.

Highlights

• Python SDK — Agent() with zero-config bootstrap, async send/inbox
• End-to-end encryption — NaCl Box (Curve25519 + XSalsa20 + Poly1305)
• Ed25519 signed envelopes — every message is signed and verifiable
• Relay server — FastAPI with WebSocket routing, store-and-forward, webhooks
• CLI — uam init, uam send, uam inbox, uam whoami, uam contacts, uam card
• MCP server — expose UAM as tools for any MCP-compatible AI framework
• Spam defense — reputation scoring, adaptive rate limits, allow/blocklists
• DNS domain verification — Tier 2 verified addresses via TXT records
• Three-tier addressing — relay (Tier 1), DNS-verified (Tier 2), on-chain namespace (Tier 3)

Install

pip install youam

Links

• Docs: https://docs.youam.network
• Website: https://youam.network