# Hot Dev

> Open source platform for backend workflows and AI agents.

Hot Dev combines a workflow language, runtime, CLI, local dashboard, events, schedules, webhooks, tasks, containers, MCP services, packages, deployment, and observability.

## Documentation

- [Hot Docs](https://hot.dev/docs): Start with the Hot Dev docs for language basics, platform concepts, packages, and deployment workflows.
- [Getting Started](https://hot.dev/docs/getting-started): Install Hot Dev, create your first project, run functions locally, and trigger your first event handler.
- [Adopting Hot in an Existing Application](https://hot.dev/docs/adopting-hot): Adopt Hot incrementally beside an existing application by moving one webhook, event, schedule, queue worker, agent, or container job at a time.
- [AI Coding Assistants](https://hot.dev/docs/ai-coding): Teach AI coding assistants the Hot language and agent SDKs with hot ai add, AGENTS.md, bundled skills, and LLM-readable documentation.
- [Demos](https://hot.dev/docs/demos): Try runnable Hot Dev demos for agents, workflows, integrations, platform features, and application patterns.
- [Hot Chat Demo](https://hot.dev/docs/demos/hot-chat): Run Hot Chat to explore personal and team AI agents, slash commands, memory, file attachments, and streaming replies.
- [Hot Language](https://hot.dev/docs/language): Get a quick introduction to Hot syntax and find the detailed language guides.
- [Language Evaluation Model](https://hot.dev/docs/language/execution-model): Understand how Hot evaluates code within a single platform run or task attempt.
- [Vars and Values](https://hot.dev/docs/language/vars-and-values): Understand Hot's Var and Value model, including literals, definitions, references, bindings, namespaces, and immutability.
- [Data Literals](https://hot.dev/docs/language/data-literals): Write Hot literals for strings, numbers, booleans, arrays, maps, optional values, and structured data.
- [Functions](https://hot.dev/docs/language/functions): Define and call Hot functions, including typed parameters, return values, metadata, handlers, and reusable logic.
- [Metadata](https://hot.dev/docs/language/meta): Attach metadata to Hot functions and types to define handlers, schedules, webhooks, MCP tools, agents, docs, and deploy behavior.
- [Types](https://hot.dev/docs/language/types): Define Hot types with structs, enums, nullable values, collections, coercions, Result types, and type-safe contracts.
- [Error Handling](https://hot.dev/docs/language/errors): Understand Hot Result values, automatic wrapping and unwrapping, lazy result checks, short-circuiting, and fail handling.
- [Flows](https://hot.dev/docs/language/flows): Use Hot flows for sequential logic, conditionals, matches, parallel work, and branch-based execution.
- [What Hot Doesn't Have](https://hot.dev/docs/language/not-supported): See what Hot intentionally leaves out, including syntax and language features replaced by Hot-specific patterns.
- [Hot Platform](https://hot.dev/docs/platform): Understand Hot's platform model for projects, functions, runs, events, streams, tasks, durability, and observability.
- [Platform Execution Model](https://hot.dev/docs/platform/execution-model): Understand how Hot connects events, handlers, runs, retries, tasks, workers, and streams into durable workflows.
- [Runs, Events & Streams](https://hot.dev/docs/platform/runs-events-streams): Reference Hot run and event records, stream lineage, live output, logs, traces, and lifecycle states.
- [Durable Execution](https://hot.dev/docs/platform/durability): See how Hot persists runs and event chains, retries failed steps with the same input, and records execution history.
- [Tasks](https://hot.dev/docs/tasks): Choose between short-lived Hot runs and long-running tasks, including TaskInfo, code tasks, container tasks, and messaging.
- [Events and Event Handlers](https://hot.dev/docs/events): Build event-driven workflows in Hot with typed event handlers, emitted events, async execution, and run tracking.
- [Agents](https://hot.dev/docs/agents): Build AI agents with Hot metadata, handlers, tools, memory patterns, commands, graph inspection, and deployment.
- [Schedules](https://hot.dev/docs/schedules): Run Hot functions on a schedule with cron expressions, natural-language schedules, retries, and dynamic schedules.
- [Retries](https://hot.dev/docs/retries): Configure retries for Hot handlers, schedules, webhooks, and workflows with attempts, delays, and failure behavior.
- [Alerts](https://hot.dev/docs/alerts): Set up alert channels, destinations, and subscriptions for run failures, deploy events, and custom Hot alert calls.
- [Containers (Hot Box)](https://hot.dev/docs/box): Use Hot Box containers to run external tools, custom runtimes, binaries, and isolated task workloads from Hot code.
- [Container Billing (CUS)](https://hot.dev/docs/box/billing): Understand Hot Box billing with Compute Unit Seconds (CUS), plan quotas, overages, and organization budgets.
- [HOT API](https://hot.dev/docs/api): REST API reference for Hot projects, builds, runs, tasks, events, streams, files, secrets, agents, MCP services, and API keys.
- [SDKs](https://hot.dev/docs/api/sdks): Official Hot SDKs for JavaScript, Python, Go, Rust, and Java: install, quick start, streaming, and error handling.
- [MCP Services](https://hot.dev/docs/mcp): Expose Hot functions as MCP tools and connect AI clients to Hot-hosted MCP services over streamable HTTP or SSE.
- [Webhooks](https://hot.dev/docs/webhooks): Expose Hot functions as webhooks with request handling, authentication, deployment, and event-driven follow-up work.
- [Custom Domains](https://hot.dev/docs/domains): Configure custom domains for Hot Cloud apps, including DNS, certificates, verification, and production routing.
- [Authentication](https://hot.dev/docs/authentication): Use API keys, service keys, and sessions with the Hot API, including bearer auth, access levels, and permissions.
- [Hot App](https://hot.dev/docs/app): Use the Hot App dashboard to inspect projects, runs, events, traces, streams, logs, agents, and deployment state.
- [Hot CLI](https://hot.dev/docs/cli): Use the Hot CLI to create projects, run checks and tests, deploy apps, manage packages, and inspect resources.
- [Hot Configuration](https://hot.dev/docs/configuration): Configure a Hot workspace with hot.hot projects, dependencies, profiles, services, and environment-backed settings.
- [Dependencies](https://hot.dev/docs/configuration/dependencies): Declare project package dependencies in hot.hot using registry versions, Git repositories, and local paths.
- [Projects](https://hot.dev/docs/configuration/projects): Configure multiple Hot projects in one workspace with source paths, tests, dependencies, defaults, and store settings.
- [Hot Package Creation](https://hot.dev/docs/packages): Create reusable Hot packages with namespaces, functions, types, metadata, documentation, and versioned distribution.
- [Package Manifest](https://hot.dev/docs/packages/manifest): Write pkg.hot manifests with package metadata, descriptions, tags, versions, dependencies, and publishing configuration.
- [Package Dependencies](https://hot.dev/docs/packages/dependencies): Declare package dependencies in pkg.hot and understand version, Git, local, transitive, and circular dependency behavior.
- [Publishing Packages](https://hot.dev/docs/packages/publishing): Publish Hot packages with versioning, naming rules, package docs, metadata, and registry-ready structure.
- [CI/CD](https://hot.dev/docs/ci-cd): Automate hot check, hot test, and hot deploy in GitHub Actions and other CI with setup-hot.
- [Migrations and Upgrades](https://hot.dev/docs/migrations): Upgrade Hot and move local SQLite databases from 1.x to 2 with hot update and hot db port-v1-to-v2.
- [VS Code & LSP](https://hot.dev/docs/editor): Use the Hot VS Code extension and language server for syntax highlighting, diagnostics, navigation, and editor feedback.

## Additional resources

- [Full documentation](https://hot.dev/llms-full.txt): All public user documentation in navigation order.
- [Package documentation](https://hot.dev/pkg): Typed standard-library and integration package references.
- [GitHub](https://github.com/hot-dev/hot): Apache 2.0 source for the Hot language, runtime, CLI, dashboard, and platform.