← all repositories
photon-hq/spectrum-ts

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.

1.1k stars TypeScript Agents
spectrum-ts
Velocity · 7d
+8.3
★ / day
Trend
cooling
star history

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

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.