AEDOS

Nostr Moderation Oracle

Aedos reviews content once and shares reusable verdicts.

Aedos is a self-hosted AI-powered moderation oracle for Nostr. It checks notes, hashtags, images, and videos, caches verdicts by event and media hash, and publishes labels that relays and clients can choose to trust.

Review Scope Notes, tags, images, videos
Trust Boundary Signed Nostr events
Media Storage No media bytes stored
Primary API WebSocket + HTTP
AI Review

Provider Agnostic

Aedos can use a local deterministic test reviewer or an external AI moderation provider such as OpenAI. Secrets and API keys are never shown on this public page.

Media

No Media Bytes Stored

Aedos stores URLs, hashes, metadata, and verdict summaries. Images and videos are fetched for review, but media bytes are not stored in Postgres.

Text Tags

Hashtags And Nostr Topics

Text rules only match hashtags and Nostr ["t", "..."] topic tags. Ordinary prose is not scanned for isolated marker words.

Signed Events

Notes Prove Their Own Media

Aedos verifies full signed events directly, or fetches the signed event from configured relays when only an event ID is supplied. Caller-supplied media links are not trusted unless they appear in the signed note.

Video

Frame Sampling

Videos are reviewed by sampling visual frames. Audio, subtitles, playlists, and hidden streams are not treated as reviewed content.

Nostr Labels

NIP-32 Friendly

Verdicts can be published as NIP-32 kind 1985 label events, signed by the Aedos operator key so clients and relays can verify the source.

Cache

Reviewed Once

Completed verdicts are reused by event ID and media hash. Repeated checks can return quickly without sending the same media back through the AI reviewer.

Verdicts

Advisory Signals

Aedos returns labels such as safe, warn, block, unknown, and error. Relays and clients decide how strict their own filtering should be.

Safety Process

CSAM Needs Operations

Code can flag, filter, and label suspected material, but operators still need their own legal process, access controls, retention policy, and escalation path.

Secrets

No Keys On This Page

The public page can explain the provider class and integration surface, but API keys, OpenAI keys, admin passwords, and Nostr private keys stay inside operator-only settings.

Limitations

Not Perfect Judgement

AI review and tag rules can make mistakes. Aedos is designed to make review results reusable, auditable, and easy to override.

Integration

Relays and clients can use HTTP, WebSockets, or Nostr labels.

WebSocket is the best fit for relays and feed clients: submit a signed event or event reference, keep the connection open, and receive updates as verdicts complete.

Scoped WebSocket
/v1/ws
Trusted Firehose
/v1/ws/firehose
Submit Check
POST /v1/check
Event References
hex, note..., nevent...
Preferred Payload
raw_event
Label Events
NIP-32 kind 1985