Spectrum

Bring agents to any interface.

Photon (photon.codes) builds Spectrum, a multi-channel agent framework that makes AI agents reachable over real conversation surfaces like iMessage, SMS, and email instead of trapping them in web chat.

npm version npm downloads license TypeScript github stars

## About Photon **[Photon](https://photon.codes)** builds infrastructure for AI agents that operate over real communication channels. Spectrum is Photon’s open-source multi-channel agent framework, enabling AI agents to communicate through interfaces people already use—such as iMessage, SMS, email, Slack, Discord, and voice—instead of being confined to web chat. Learn more at **https://photon.codes**. ## Getting Started The fastest way to ship is with **Spectrum Cloud** — hosted infrastructure for platforms like iMessage, with credentials ready in minutes. 1. Sign up at **[app.photon.codes](https://app.photon.codes)** to get your project ID and secret. 2. Install the SDK: ```bash bun add spectrum-ts ``` 3. Start your app: ```typescript import { Spectrum } from "spectrum-ts"; import { imessage } from "spectrum-ts/providers/imessage"; const app = await Spectrum({ projectId: process.env.PROJECT_ID, projectSecret: process.env.PROJECT_SECRET, providers: [imessage.config()], }); for await (const [space, message] of app.messages) { await space.responding(async () => { await message.reply("Hello from Spectrum."); }); } ``` Spectrum also runs fully standalone — you can connect to a local iMessage database, bring your own gRPC endpoints, or build your own platform provider. See the [docs](https://docs.photon.codes) for self-hosted setups. ## Documentation Visit **[docs.photon.codes](https://docs.photon.codes)** to view the full documentation. ## Platforms | Platform | Package | |----------|---------| | iMessage | `spectrum-ts/providers/imessage` | | WhatsApp | `spectrum-ts/providers/whatsapp` | | Telegram | `spectrum-ts/providers/telegram` | | Terminal | `spectrum-ts/providers/terminal` | | Custom | `definePlatform` from `spectrum-ts` | ## Issues Found a bug or have a feature request? Please [open an issue](https://github.com/photon-hq/spectrum-ts/issues) on GitHub. Before filing, search existing issues to avoid duplicates. ## Contributing Contributions are welcome. Please read [CONTRIBUTING.md](./CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests. ## License [MIT](./LICENSE) © [Photon](https://photon.codes)