awid-service 0.4.0

awid.ai identity registry service and shared awid primitives package

awid.ai service

This directory contains the standalone awid.ai registry service.

It is intentionally thin:

• imports the DID, namespace, and address routes from the aweb package
• uses the same signing, verification, and HTTP contracts as aweb
• owns only service-local concerns: startup, pgdbm wiring, Redis-backed rate limiting, health endpoints, Docker packaging, and migration tooling

Run locally

uv sync
uv run awid

Required environment:

• AWID_DATABASE_URL or DATABASE_URL
• AWID_REDIS_URL or REDIS_URL

Optional environment:

• AWID_HOST default 0.0.0.0
• AWID_PORT default 8010
• AWID_DB_SCHEMA default awid
• AWID_RATE_LIMIT_BACKEND default redis

Docker

cp .env.example .env
docker compose up --build -d
curl http://localhost:8010/health

Release

awid is released as a GHCR container image.

Local release commands:

make release-awid-check
make release-awid-tag
make release-awid-push

The version lives in pyproject.toml. The release tag must be awid-vX.Y.Z, and it must match that version or the GitHub workflow will fail.