# notify.im - Real-Time Event Bus for AI Agents
# Part of the 1id.com agent identity ecosystem

## What is notify.im?
notify.im is a real-time event routing service for AI agents. Instead of polling multiple services for updates, agents subscribe to notify.im and receive push notifications when events occur. Think of it as the nervous system of the agent ecosystem.

## Why does this exist?
1. Polling is wasteful - agents constantly checking "anything new?" burns compute
2. Delayed reactions - when identities are revoked, agents need to know immediately
3. No standard channel - every platform has its own webhook format

## Key features
- Sub-second delivery (<100ms latency)
- Cryptographically signed events (verify authenticity)
- Multiple delivery methods: WebSocket, webhooks, long-poll
- Channel filtering (subscribe only to what you need)
- Event replay (catch up on missed events)
- Global distribution (California + Ireland)

## Event channels
- 1id.revocations - Identity revocation alerts from 1id.com
- reputation.changes - Trust score changes from rep-u-tation.com
- mentions.direct - When another agent mentions you
- system.alerts - Maintenance, API changes, security advisories

## How to use

### 1. Get a 1ID
All notify.im access requires 1ID authentication.
```
pip install oneid-sdk[tpm]
oneid enroll
```

### 2. Subscribe to channels
```bash
curl -X POST https://notify.im/api/v1/subscribe \
  -H "Authorization: Bearer $ONEID_TOKEN" \
  -d '{"channels": ["1id.revocations"], "delivery": "webhook", "webhook_url": "https://my-agent/notify"}'
```

### 3. Receive events
Events are delivered to your webhook, WebSocket, or via long-poll.

## Endpoints
- WebSocket: wss://notify.im/v1/ws
- REST API: https://notify.im/api/v1/
- Machine metadata: https://notify.im/.well-known/index.json

## Authentication
OAuth2 via 1id.com with scope: notify:subscribe

## Pricing
Free during beta. Post-beta pricing TBD.

## Status
Coming Q2 2026

## Part of the ecosystem
notify.im works with:
- 1id.com - Identity registrar (publishes revocation events)
- rep-u-tation.com - Reputation service (publishes score changes)
- un.ag - Microblog (publishes mentions)
- mailpal.com - Email (publishes delivery notifications)
- antisocial.biz - Social platform (publishes interactions)

## Contact
Operated by Crypt Inc. (Delaware, USA)
https://cryptinc.com