Priority comes from the bump: major is FLASH, minor BULLETIN, patch ROUTINE.
Angelia is the self-hosted release event bus. It watches PyPI, npm, crates.io and GitHub or GitLab releases, turns every new version into one signed CloudEvent, and delivers it to your CI, your chat or your AI agents.
v0.2.01 binary6 sources3 sinks + pull, SSE, MCPSQLite or PostgresApache-2.0
What to do about a release stays with you. Angelia's job is to make sure you hear about every one, once, in a shape every consumer understands.
A scheduler checks each target on its own interval with per-host rate limits and conditional requests.
Fifty watches on pypi:requests cost one fetch.
SemVer, PEP 440, calver: every new version is diffed against the known set, so a backport like
1.9.4 after 2.0.0 is caught. Policies filter and cool down.
One immutable event, one delivery per subscriber, written in the same transaction. Retries with backoff, dead letters, replay.
Whatever the source, whatever the sink, consumers read the same CloudEvent, specified by a JSON Schema.
{
"type": "dev.angelia.release.published.v1",
"id": "01JBX2A7C8D9E0F1G2H3J4K5M6",
"subject": "pypi:requests@2.33.0",
"data": {
"package": "requests",
"version": "2.33.0",
"previous_version": "2.32.5",
"bump": "minor",
"backport": false,
"scheme": "pep440",
"urls": { "release": "https://pypi.org/project/requests/2.33.0/" },
"watch": { "name": "requests", "labels": { "team": "platform" } },
"purl": "pkg:pypi/requests@2.33.0"
}
}
Push to the systems that can be called. Let the others pull, from a cursor that never skips.
| Desk | For | Sink |
|---|---|---|
| Webhook | Your CI server, n8n, a Lambda, your own bot. Signed with Standard Webhooks. Webhooks | kind: webhook |
| GitHub Actions | Run tests against the new version, open an update PR, start an agent. Dispatch | kind: github-dispatch |
| Chat and push | Slack, Discord, Telegram, ntfy, Gotify, Matrix, with your own message template. Chat | kind: shoutrrr |
| Pull and stream | Consumers with no public URL: named cursors, acknowledgements, server-sent events. Pull API | GET /v1/events |
| AI agents | Ask what changed, read events, add a watch, through MCP with scoped tokens. MCP | angelia mcp |
A real setup, end to end, for a custom integration that must keep up with Home Assistant every month.
home-assistant/core publish a release, betas included.ha-release to the integration's repository, after a one-hour cooldown.One container with SQLite on a volume. The binary is static, signed and attested when you outgrow it.
# one container, SQLite, loopback only
$ git clone --depth 1 https://github.com/angelia-dev/angelia && cd angelia/deploy/compose/sqlite
$ docker run --rm ghcr.io/angelia-dev/angelia:0.2.0 token generate > bootstrap-token && chmod 0644 bootstrap-token
$ docker compose up -d
# then say what to watch, in watches.yaml
version: 1
watches:
- name: home-assistant
source: github-release
coordinates: { repo: home-assistant/core }
scheme: calver
Angelia is pre-1.0. This is the honest ledger of v0.2.0.
Angelia, from the ancient Greek for "message, news": the herald's daughter, now running your release wire.