Skip to main content

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
  • AWID_SERVICE_TOKEN optional for standalone AWID, but required when AWID serves an aweb deployment. Configure the same >=32-byte value on both so aweb can read private-team keys and revocations and bypass the public-IP rate limits on all registry reads. Write limits and identity-private/blob authentication still apply. awid_service_exempt logs cumulative per-bucket, process-local exemption counts at 1, 2, 4, 8 and later powers of two; the token is never logged. See the trust model.

Docker

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

Release

awid is released as a GHCR container image through the repository's release skill and driver. The driver owns planning, exact-byte staging, publication, tagging, registry verification, and the receipt; do not start a release by pushing an awid-vX.Y.Z tag. The version remains in pyproject.toml.

Metadata

Release files for awid-service 0.5.21

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for awid-service 0.5.21
File Size Uploaded
awid_service-0.5.21.tar.gz 281.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for awid-service 0.5.21
File Interpreter ABI Platform
awid_service-0.5.21-py3-none-any.whl Python 3 none any Details

Total release size: 384.1 kB

Release files / awid_service-0.5.21.tar.gz

Download URL awid_service-0.5.21.tar.gz
Size 281.0 kB
Tags Source
SHA-256 checksum
How to use checksums
64e2d1f30dbb8e433a1694b1abe4150709c96f803e0b88f739dd4c26c2ebcff6
BLAKE2b-256 checksum
How to use checksums
43f22f71afa3eaf0ae027d48ba36a2185646339eb811ce2929417fd5cfcbb815
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / awid_service-0.5.21-py3-none-any.whl

Download URL awid_service-0.5.21-py3-none-any.whl
Size 103.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7c89aa20ac9202ce87c7d1f6351373d9b72bd60b915ebe42858e54013e16139a
BLAKE2b-256 checksum
How to use checksums
14d50ac6bc0941329bdd6dddf2227a3c47110903c0eaf0020901e7cffc15d229
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

0.5.28

2 release files

0.5.27

2 release files

0.5.26

2 release files

0.5.25

2 release files

0.5.24

2 release files

0.5.23

2 release files

0.5.22

2 release files

This release

0.5.21 This release

2 release files

0.5.20

2 release files

0.5.19

2 release files

0.5.18

2 release files

0.5.17

2 release files

0.5.16

2 release files

0.5.15

2 release files

0.5.13

2 release files

0.5.9

2 release files

0.5.8

2 release files

0.5.7

2 release files

0.5.6

2 release files

0.5.5

2 release files

0.5.4

2 release files

0.5.3

2 release files

0.5.2

2 release files

0.5.1

2 release files

0.4.0

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page