Skip to main content
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 — per-user OAuth connect and the MCP card toolset.

​
Run it

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 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.

Photon example on GitHub

The runnable folder — provider, Agentcard wiring, and offline tests.