Skip to content

Open source TypeScript runtime for the agentic age

One capability. Every surface agents and humans need.

Photon turns a single .photon.ts file into MCP tools, CLI commands, Beam apps, embedded chat UIs, web routes, scheduled jobs, webhooks, retries, and verifiable runtime contracts.

gh repo star portel-dev/photon
Photon weather app rendered as an embedded UI

The core move

Write intent once. Photon derives the interfaces around it.

One Photon method becoming CLI, Beam, MCP, Claude Desktop, ChatGPT, and other agent surfaces

Real clients

The same Photon can show up where work actually happens.

ChatGPT developer mode rendering a Photon weather app
ChatGPT developer mode through a public HTTPS MCP endpoint.
Claude Desktop rendering the same Photon weather app
Claude Desktop through a local MCP server.

Choose your path

Start with the shape of the thing you want to build.

Mental model

Small enough to verify. Useful enough to compose.

Photon agentic stack infographic

Portel ecosystem

Photon builds reliable capabilities. NCP helps agents find and use them.

Use Photon when you want to turn TypeScript into trusted tools, apps, routes, schedules, and workflows. Use NCP when an agent needs one natural MCP interface over a larger tool ecosystem.

Make a capability agents can trust and humans can operate.

Released under the MIT License.