Get started¶
Angelia watches the places your dependencies are published, notices every new version, and tells the systems that care. It runs as one binary or one container, keeps its state in SQLite or Postgres, and needs no queue.
Three ideas carry the whole product:
- Watch
- What to look at: a package on PyPI, npm or crates.io, the releases or tags of a GitHub repository, the releases of a GitLab project. Each watch has an interval and a policy.
- Sink
- Where to deliver: a signed webhook, a GitHub Actions dispatch, or a chat or push service. Consumers that cannot receive a call can pull instead, or ask through MCP.
- Subscription
- The wire between them: which events reach which sink, with filters and an optional message template.
Pick your path¶
| You want to | Go to |
|---|---|
| See it work in five minutes, with Docker | Quickstart |
| Install a verified binary as a service | Install |
| Receive and verify your first signed event | Your first event |
| Add a watch, a sink and a subscription from the admin UI | After the first install |
| Watch a narrated tour first | Video tour |
| Trigger an AI agent when an upstream releases | Home Assistant to an agentic PR |
Where Angelia stands
Angelia is pre-1.0. v0.2.0 is the current release: push delivery (webhooks, GitHub dispatch, chat), the REST API with tokens, the pull API, SSE, MCP and the Postgres store all ship in it. Sources and sinks listed on these pages exist today; anything planned is marked as planned.