Your agent shouldn't care if it's texting iMessage or WhatsApp
A TypeScript SDK that unifies messaging platforms so you write agent logic once and deploy it anywhere.

What it does
Spectrum is a TypeScript messaging SDK that abstracts the plumbing of individual chat platforms. You write agent logic once against its unified API, then route messages to iMessage, WhatsApp, a terminal, or a custom channel without rewriting the core logic. It handles platform-specific noise so your code doesn’t have to.
The interesting bit
The dual-mode architecture is the quiet win: you can lean on Spectrum Cloud for hosted infrastructure with ready-made credentials, or run the whole thing standalone against a local iMessage database or your own gRPC endpoints. That flexibility is rarer than it should be in messaging SDKs, which usually force a SaaS dependency or leave you to raw platform APIs.
Key highlights
- First-party providers for iMessage, WhatsApp, and terminal, plus a
definePlatformhook for custom channels - Fully type-safe interface targeting TypeScript 5+
- Can run standalone against local databases or gRPC endpoints, or through managed Spectrum Cloud infrastructure
- Abstracts platform-specific message formats into a single agent-facing API
Verdict
Worth a look if you’re building agents that need to reach humans across multiple chat apps without maintaining a tangle of platform-specific adapters. Skip it if you’re only targeting one channel and prefer to couple directly to its native SDK.
Frequently asked
- What is photon-hq/spectrum-ts?
- A TypeScript SDK that unifies messaging platforms so you write agent logic once and deploy it anywhere.
- Is spectrum-ts open source?
- Yes — photon-hq/spectrum-ts is open source, released under the MIT license.
- What language is spectrum-ts written in?
- photon-hq/spectrum-ts is primarily written in TypeScript.
- How popular is spectrum-ts?
- photon-hq/spectrum-ts has 1.1k stars on GitHub and is currently cooling off.
- Where can I find spectrum-ts?
- photon-hq/spectrum-ts is on GitHub at https://github.com/photon-hq/spectrum-ts.