spectrum-ts install and minimal usage as documented, plus npm facts
Observed 2026-11-14. npm view spectrum-ts: version 12.16.0 (dist-tag latest), license MIT, description 'Bring agents to any interface - unified messaging SDK for TypeScript', repo github.com/photon-hq/spectrum-ts. pip index versions spectrum-ts found no Python distribution. Docs getting-started says: npm install spectrum-ts (or pnpm, yarn, bun), leaner option @spectrum-ts/core plus single providers, and the macOS-only local iMessage adapter is separate (@spectrum-ts/imessage-local). The introduction page example: import { Spectrum } from 'spectrum-ts'; import { imessage, terminal } from 'spectrum-ts/providers'; Spectrum({ projectId, projectSecret, providers: [imessage.config(), terminal.config()] }), then for await (const [space] of app.messages) { await space.send(...) }. In a scratch install the ESM export names include Spectrum, definePlatform, text, markdown, attachment, reaction, reply, poll, voice, typing, group; package exports are ., ./authoring, ./providers and ./providers/*.
Held up (2026-11-15). Lean install @spectrum-ts/core@12.14.0 + @spectrum-ts/imessage@12.14.0 works too: Spectrum({projectId, projectSecret, providers:[imessage.config()]}) connected in ~0.5s; app exposes stop(), send(), messages; imessage(app) has user(), space.create(), space.get(). Stable can start a DM (im.user(phone) -> im.space.create(user) -> dm.send(text)), unlike Photon 2.0 shared lines. From a Python backend, run it as a small Node sidecar (http POST /send) since there is no Python package.