> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Photon

> Claude agent on Photon (Spectrum), with Agentcard cards per user

Photon's Spectrum framework gives an agent one unified message loop across messaging surfaces — iMessage, WhatsApp, Slack, Telegram, terminal. This is the repo's **reference build**: the shape every other example reproduces, targeting iMessage, with the full [Agentcard integration](/companies/examples/overview) — per-user OAuth connect and the MCP card toolset.

## Run it

```bash theme={null}
git clone https://github.com/tiny-agent-company/example-implementations
cd example-implementations/photon
bun install
cp .env.example .env   # add ANTHROPIC_API_KEY
bun run dev            # terminal mode — chat locally, zero vendor credentials
bun run start          # iMessage mode via Photon
```

iMessage mode needs `PROJECT_ID` / `PROJECT_SECRET` from your [Photon](https://photon.codes) project settings and a provisioned managed iMessage line — then text the line and watch delivery in the Photon dashboard.

In terminal mode you can drive the whole Agentcard flow — ask the agent for a card, tap the connect link it hands you, and watch it mint one in sandbox.

<Card title="Photon example on GitHub" icon="github" href="https://github.com/tiny-agent-company/example-implementations/tree/main/photon">
  The runnable folder — provider, Agentcard wiring, and offline tests.
</Card>