{"adoption": {"forks": 189, "observed_at": "2026-08-28T04:04:53.614415+00:00", "stars": 1496}, "canonical_url": "https://ross.abutalabs.com/products/spectrum-ts", "card": {"archived": false, "artifact_type": "framework", "description": "Bring agents to any interfaces", "domain": ["chatbots", "messaging-platforms", "developer-tools"], "enriched": true, "function": ["agent-framework", "chatbot", "sdk", "webhook", "http-server", "cli"], "health_score": 100, "homepage": "https://photon.codes/spectrum", "language": "TypeScript", "license": "MIT", "license_family": "permissive", "maturity": "active", "member_repos": ["photon-hq/spectrum-ts"], "name": "photon-hq/spectrum-ts", "platform": ["bun", "cross-platform", "cli", "self-hosted", "cloud"], "pushed_at": "2026-08-24T23:25:24+00:00", "repo": "photon-hq/spectrum-ts", "stars": 1496, "tags": ["messaging", "imessage", "whatsapp", "telegram", "sms", "multi-channel", "agent-infrastructure", "voice", "unified-messaging", "ai-agents", "automation", "nodejs", "typescript"], "topics": ["agent", "photon", "typescript", "ai"], "urls": [], "use_cases": ["build an AI agent that replies over iMessage", "connect a chatbot to WhatsApp Business and Telegram", "run one agent server across multiple messaging channels", "send SMS with iMessage fallback routing", "build a Telegram bot with webhooks in TypeScript", "self-host an agent connected to a local iMessage database", "add voice call support to an AI agent"], "what_it_is": "Spectrum (by Photon) is an open-source TypeScript framework for building AI agents that communicate over real messaging interfaces like iMessage, WhatsApp, Telegram, SMS/RCS, Slack, Discord, and voice. It provides a unified SDK with pluggable providers, a runtime for handling inbound messages, and optional hosted infrastructure (Spectrum Cloud) or fully self-hosted setups.", "when_to_avoid": ["you only need a simple web chat widget", "your project is not in the JavaScript/TypeScript ecosystem", "you need channels Spectrum does not yet support and cannot build a custom provider"], "when_to_choose": ["you want agents reachable on native messaging apps instead of web chat", "you need one unified API across iMessage, WhatsApp, Telegram, and SMS", "you want a batteries-included TypeScript SDK with managed or self-hosted options"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/spectrum-ts", "repo": "photon-hq/spectrum-ts", "role": "main", "score": 78}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:04:53.614415+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-30T04:33:14.222368+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a6a9be785e033002c8301000b7afb231bc1ee11745f5735c903643cc341b09a5", "fetched_at": "2026-08-28T04:04:53.614415+00:00", "kind": "readme", "missing": false, "url": "https://github.com/photon-hq/spectrum-ts"}, {"content_hash": "870d35a2290d88ba710089bb0851451ff7991ec2bd25f6f10486a5e26161f78e", "fetched_at": "2026-08-29T11:38:54.021870+00:00", "kind": "homepage", "missing": false, "url": "https://photon.codes/spectrum"}, {"content_hash": "b0a9dd22d5b3f518a8cd1ecbfba5e3470aa9018b0aae121406ed11874f8dd14d", "fetched_at": "2026-08-29T11:38:54.033081+00:00", "kind": "site_page", "missing": false, "url": "https://docs.photon.codes"}, {"content_hash": "9c43376f05c8dfc08827e658870fa038dadb48b8c24fb852eaeae0398b25785c", "fetched_at": "2026-08-29T11:38:54.035131+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/spectrum-ts"}, {"content_hash": "7ad035be5a4489fe431894281c25ec5a0cd4ab8e4feb9c188ad83742eecb3ae1", "fetched_at": "2026-08-29T11:38:54.030952+00:00", "kind": "site_page", "missing": false, "url": "https://photon.codes/pricing"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:04:53.614415+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-30T04:33:14.222368+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a6a9be785e033002c8301000b7afb231bc1ee11745f5735c903643cc341b09a5", "fetched_at": "2026-08-28T04:04:53.614415+00:00", "kind": "readme", "missing": false, "url": "https://github.com/photon-hq/spectrum-ts"}, {"content_hash": "870d35a2290d88ba710089bb0851451ff7991ec2bd25f6f10486a5e26161f78e", "fetched_at": "2026-08-29T11:38:54.021870+00:00", "kind": "homepage", "missing": false, "url": "https://photon.codes/spectrum"}, {"content_hash": "b0a9dd22d5b3f518a8cd1ecbfba5e3470aa9018b0aae121406ed11874f8dd14d", "fetched_at": "2026-08-29T11:38:54.033081+00:00", "kind": "site_page", "missing": false, "url": "https://docs.photon.codes"}, {"content_hash": "9c43376f05c8dfc08827e658870fa038dadb48b8c24fb852eaeae0398b25785c", "fetched_at": "2026-08-29T11:38:54.035131+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/spectrum-ts"}, {"content_hash": "7ad035be5a4489fe431894281c25ec5a0cd4ab8e4feb9c188ad83742eecb3ae1", "fetched_at": "2026-08-29T11:38:54.030952+00:00", "kind": "site_page", "missing": false, "url": "https://photon.codes/pricing"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-30T04:33:14.222368+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a6a9be785e033002c8301000b7afb231bc1ee11745f5735c903643cc341b09a5", "fetched_at": "2026-08-28T04:04:53.614415+00:00", "kind": "readme", "missing": false, "url": "https://github.com/photon-hq/spectrum-ts"}, {"content_hash": "870d35a2290d88ba710089bb0851451ff7991ec2bd25f6f10486a5e26161f78e", "fetched_at": "2026-08-29T11:38:54.021870+00:00", "kind": "homepage", "missing": false, "url": "https://photon.codes/spectrum"}, {"content_hash": "b0a9dd22d5b3f518a8cd1ecbfba5e3470aa9018b0aae121406ed11874f8dd14d", "fetched_at": "2026-08-29T11:38:54.033081+00:00", "kind": "site_page", "missing": false, "url": "https://docs.photon.codes"}, {"content_hash": "9c43376f05c8dfc08827e658870fa038dadb48b8c24fb852eaeae0398b25785c", "fetched_at": "2026-08-29T11:38:54.035131+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/spectrum-ts"}, {"content_hash": "7ad035be5a4489fe431894281c25ec5a0cd4ab8e4feb9c188ad83742eecb3ae1", "fetched_at": "2026-08-29T11:38:54.030952+00:00", "kind": "site_page", "missing": false, "url": "https://photon.codes/pricing"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:04:53.614415+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:04:53.614415+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:04:53.614415+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-30T04:33:14.222368+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a6a9be785e033002c8301000b7afb231bc1ee11745f5735c903643cc341b09a5", "fetched_at": "2026-08-28T04:04:53.614415+00:00", "kind": "readme", "missing": false, "url": "https://github.com/photon-hq/spectrum-ts"}, {"content_hash": "870d35a2290d88ba710089bb0851451ff7991ec2bd25f6f10486a5e26161f78e", "fetched_at": "2026-08-29T11:38:54.021870+00:00", "kind": "homepage", "missing": false, "url": "https://photon.codes/spectrum"}, {"content_hash": "b0a9dd22d5b3f518a8cd1ecbfba5e3470aa9018b0aae121406ed11874f8dd14d", "fetched_at": "2026-08-29T11:38:54.033081+00:00", "kind": "site_page", "missing": false, "url": "https://docs.photon.codes"}, {"content_hash": "9c43376f05c8dfc08827e658870fa038dadb48b8c24fb852eaeae0398b25785c", "fetched_at": "2026-08-29T11:38:54.035131+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/spectrum-ts"}, {"content_hash": "7ad035be5a4489fe431894281c25ec5a0cd4ab8e4feb9c188ad83742eecb3ae1", "fetched_at": "2026-08-29T11:38:54.030952+00:00", "kind": "site_page", "missing": false, "url": "https://photon.codes/pricing"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:04:53.614415+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:04:53.614415+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-30T04:33:14.222368+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a6a9be785e033002c8301000b7afb231bc1ee11745f5735c903643cc341b09a5", "fetched_at": "2026-08-28T04:04:53.614415+00:00", "kind": "readme", "missing": false, "url": "https://github.com/photon-hq/spectrum-ts"}, {"content_hash": "870d35a2290d88ba710089bb0851451ff7991ec2bd25f6f10486a5e26161f78e", "fetched_at": "2026-08-29T11:38:54.021870+00:00", "kind": "homepage", "missing": false, "url": "https://photon.codes/spectrum"}, {"content_hash": "b0a9dd22d5b3f518a8cd1ecbfba5e3470aa9018b0aae121406ed11874f8dd14d", "fetched_at": "2026-08-29T11:38:54.033081+00:00", "kind": "site_page", "missing": false, "url": "https://docs.photon.codes"}, {"content_hash": "9c43376f05c8dfc08827e658870fa038dadb48b8c24fb852eaeae0398b25785c", "fetched_at": "2026-08-29T11:38:54.035131+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/spectrum-ts"}, {"content_hash": "7ad035be5a4489fe431894281c25ec5a0cd4ab8e4feb9c188ad83742eecb3ae1", "fetched_at": "2026-08-29T11:38:54.030952+00:00", "kind": "site_page", "missing": false, "url": "https://photon.codes/pricing"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:04:53.614415+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:04:53.614415+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:04:53.614415+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-30T04:33:14.222368+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a6a9be785e033002c8301000b7afb231bc1ee11745f5735c903643cc341b09a5", "fetched_at": "2026-08-28T04:04:53.614415+00:00", "kind": "readme", "missing": false, "url": "https://github.com/photon-hq/spectrum-ts"}, {"content_hash": "870d35a2290d88ba710089bb0851451ff7991ec2bd25f6f10486a5e26161f78e", "fetched_at": "2026-08-29T11:38:54.021870+00:00", "kind": "homepage", "missing": false, "url": "https://photon.codes/spectrum"}, {"content_hash": "b0a9dd22d5b3f518a8cd1ecbfba5e3470aa9018b0aae121406ed11874f8dd14d", "fetched_at": "2026-08-29T11:38:54.033081+00:00", "kind": "site_page", "missing": false, "url": "https://docs.photon.codes"}, {"content_hash": "9c43376f05c8dfc08827e658870fa038dadb48b8c24fb852eaeae0398b25785c", "fetched_at": "2026-08-29T11:38:54.035131+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/spectrum-ts"}, {"content_hash": "7ad035be5a4489fe431894281c25ec5a0cd4ab8e4feb9c188ad83742eecb3ae1", "fetched_at": "2026-08-29T11:38:54.030952+00:00", "kind": "site_page", "missing": false, "url": "https://photon.codes/pricing"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:04:53.614415+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:04:53.614415+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-30T04:33:14.222368+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a6a9be785e033002c8301000b7afb231bc1ee11745f5735c903643cc341b09a5", "fetched_at": "2026-08-28T04:04:53.614415+00:00", "kind": "readme", "missing": false, "url": "https://github.com/photon-hq/spectrum-ts"}, {"content_hash": "870d35a2290d88ba710089bb0851451ff7991ec2bd25f6f10486a5e26161f78e", "fetched_at": "2026-08-29T11:38:54.021870+00:00", "kind": "homepage", "missing": false, "url": "https://photon.codes/spectrum"}, {"content_hash": "b0a9dd22d5b3f518a8cd1ecbfba5e3470aa9018b0aae121406ed11874f8dd14d", "fetched_at": "2026-08-29T11:38:54.033081+00:00", "kind": "site_page", "missing": false, "url": "https://docs.photon.codes"}, {"content_hash": "9c43376f05c8dfc08827e658870fa038dadb48b8c24fb852eaeae0398b25785c", "fetched_at": "2026-08-29T11:38:54.035131+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/spectrum-ts"}, {"content_hash": "7ad035be5a4489fe431894281c25ec5a0cd4ab8e4feb9c188ad83742eecb3ae1", "fetched_at": "2026-08-29T11:38:54.030952+00:00", "kind": "site_page", "missing": false, "url": "https://photon.codes/pricing"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-30T04:33:14.222368+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a6a9be785e033002c8301000b7afb231bc1ee11745f5735c903643cc341b09a5", "fetched_at": "2026-08-28T04:04:53.614415+00:00", "kind": "readme", "missing": false, "url": "https://github.com/photon-hq/spectrum-ts"}, {"content_hash": "870d35a2290d88ba710089bb0851451ff7991ec2bd25f6f10486a5e26161f78e", "fetched_at": "2026-08-29T11:38:54.021870+00:00", "kind": "homepage", "missing": false, "url": "https://photon.codes/spectrum"}, {"content_hash": "b0a9dd22d5b3f518a8cd1ecbfba5e3470aa9018b0aae121406ed11874f8dd14d", "fetched_at": "2026-08-29T11:38:54.033081+00:00", "kind": "site_page", "missing": false, "url": "https://docs.photon.codes"}, {"content_hash": "9c43376f05c8dfc08827e658870fa038dadb48b8c24fb852eaeae0398b25785c", "fetched_at": "2026-08-29T11:38:54.035131+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/spectrum-ts"}, {"content_hash": "7ad035be5a4489fe431894281c25ec5a0cd4ab8e4feb9c188ad83742eecb3ae1", "fetched_at": "2026-08-29T11:38:54.030952+00:00", "kind": "site_page", "missing": false, "url": "https://photon.codes/pricing"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-30T04:33:14.222368+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a6a9be785e033002c8301000b7afb231bc1ee11745f5735c903643cc341b09a5", "fetched_at": "2026-08-28T04:04:53.614415+00:00", "kind": "readme", "missing": false, "url": "https://github.com/photon-hq/spectrum-ts"}, {"content_hash": "870d35a2290d88ba710089bb0851451ff7991ec2bd25f6f10486a5e26161f78e", "fetched_at": "2026-08-29T11:38:54.021870+00:00", "kind": "homepage", "missing": false, "url": "https://photon.codes/spectrum"}, {"content_hash": "b0a9dd22d5b3f518a8cd1ecbfba5e3470aa9018b0aae121406ed11874f8dd14d", "fetched_at": "2026-08-29T11:38:54.033081+00:00", "kind": "site_page", "missing": false, "url": "https://docs.photon.codes"}, {"content_hash": "9c43376f05c8dfc08827e658870fa038dadb48b8c24fb852eaeae0398b25785c", "fetched_at": "2026-08-29T11:38:54.035131+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/spectrum-ts"}, {"content_hash": "7ad035be5a4489fe431894281c25ec5a0cd4ab8e4feb9c188ad83742eecb3ae1", "fetched_at": "2026-08-29T11:38:54.030952+00:00", "kind": "site_page", "missing": false, "url": "https://photon.codes/pricing"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-30T04:33:14.222368+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a6a9be785e033002c8301000b7afb231bc1ee11745f5735c903643cc341b09a5", "fetched_at": "2026-08-28T04:04:53.614415+00:00", "kind": "readme", "missing": false, "url": "https://github.com/photon-hq/spectrum-ts"}, {"content_hash": "870d35a2290d88ba710089bb0851451ff7991ec2bd25f6f10486a5e26161f78e", "fetched_at": "2026-08-29T11:38:54.021870+00:00", "kind": "homepage", "missing": false, "url": "https://photon.codes/spectrum"}, {"content_hash": "b0a9dd22d5b3f518a8cd1ecbfba5e3470aa9018b0aae121406ed11874f8dd14d", "fetched_at": "2026-08-29T11:38:54.033081+00:00", "kind": "site_page", "missing": false, "url": "https://docs.photon.codes"}, {"content_hash": "9c43376f05c8dfc08827e658870fa038dadb48b8c24fb852eaeae0398b25785c", "fetched_at": "2026-08-29T11:38:54.035131+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/spectrum-ts"}, {"content_hash": "7ad035be5a4489fe431894281c25ec5a0cd4ab8e4feb9c188ad83742eecb3ae1", "fetched_at": "2026-08-29T11:38:54.030952+00:00", "kind": "site_page", "missing": false, "url": "https://photon.codes/pricing"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 99, "longevity": 18, "rhythm": 86}, "computed_at": "2026-09-03T02:39:23.370411+00:00", "flags": [], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 256, "days_push": 9, "days_rel": 13, "gap_med": 0.0, "n_releases_24m": 87}, "score": 78, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}