# Photon

> Photon is an open source TypeScript runtime that turns a single .photon.ts class into an MCP server for AI agents, a CLI tool, and a Beam web dashboard.

## Start Here

- [Getting Started](/docs/getting-started): Install Photon and build your first .photon.ts file.
- [Core Concepts](/docs/concepts): The mental model behind methods, comments, formats, state, settings, and surfaces.
- [From Method to Chat App](/docs/tutorials/from-method-to-chat-app): A weather example that runs as CLI, Beam, MCP, and embedded chat UI.
- [Output Formats](/docs/formats): Visual result formats for tables, charts, markdown, mermaid, cards, dashboards, and more.
- [Docblock Tags](/docs/reference/DOCBLOCK-TAGS): Public reference for every docblock tag Photon understands.
- [Complete Developer Guide](/docs/GUIDE): Comprehensive reference for authoring and operating photons.

## Core Claims

- One TypeScript class can expose the same capability through MCP, CLI, and web UI.
- JSDoc comments and TypeScript types become AI-readable tool descriptions, validation, CLI help, and form UI.
- Photon supports custom MCP app UIs, schedules, webhooks, state, settings, dependency metadata, and deployment paths.

## Package

- npm: @portel/photon
- GitHub: https://github.com/portel-dev/photon
- License: MIT