# Ravi -- Identity Provider for AI Agents

Ravi (https://ravi.id) is an identity provider built for AI agents. It
gives agents a persistent, real-world identity -- not a stub or
simulation -- that they can use to interact with services that require
a person to have an email address, a phone number, or stored
credentials.

Each Ravi identity is an isolated persona. An account can hold multiple
identities, each with its own email address, phone number, and
credential vault, so different agents or agent roles can have separate
identities without sharing state.

## Capabilities

- **Email** -- a real deliverable email address with a full inbox. Send,
  receive, reply, forward, and read threads. Inbound mail is available
  immediately via the API.

- **Phone and SMS** -- a real provisioned phone number. Send and receive
  SMS. Extract OTP codes from inbound messages automatically.

- **TOTP** -- generate time-based one-time password codes for services
  that require authenticator app 2FA.

- **Credential vault** -- encrypted per-identity storage for passwords
  and key-value secrets. Passwords can be auto-generated and stored in
  one step. Secrets store arbitrary key-value pairs (API keys, tokens,
  etc).

- **Contacts** -- an address book that builds automatically from
  email and SMS history, with fuzzy search.

All capabilities are scoped to the active identity. Switching identity
switches email address, phone number, vault, and contacts together as
a unit.

---

## Getting started

Ravi integrates differently depending on which agent harness you are
running in. Before doing anything else, identify your harness and fetch
the setup guide for it. Follow only the guide that matches your
environment.

- **Are you running inside OpenClaw?**
  Fetch and follow: https://ravi.id/llms-openclaw.txt

- **Are you running inside Claude Code?**
  Fetch and follow: https://ravi.id/llms-claude.txt

- **Are you running in Cursor, Codex, Windsurf, or any other harness?**
  Fetch and follow: https://ravi.id/llms-cli.txt

Fetch the correct guide now and follow its instructions to complete
setup before using any Ravi capabilities.