Skip to content
Browse documentation
start here

Smoothie Framework

Smoothie Framework is a pre-release set of TypeScript packages and editable Starters, installed and managed with the public Smoothie CLI.

What Smoothie Framework is

Framework packages cover product interfaces, typed Services, model inference, Agents, Tools, and Workers. Starters are complete applications that you copy once and edit as your own. Your application runs on its own native tools and imports only the capabilities it uses; it does not need an Agent.

Release at a glance

Smoothie CLI0.0.17. Public download; no Framework access needed.
Smoothie Framework0.1.0. Requires Framework access through GitHub.
StatusSmoothie Framework 0.1.0 is pre-release: commercial approval and production support are pending.
SDKTypeScript only.
ToolchainBun 1.4.2 and Node 24.
Tested hostsmacOS ARM64 and Linux x64.

The CLI and the Framework are versioned separately. See Compatibility for other hosts, toolchain details, and rendering limits.

Terms

RecipeEditable application source included in a Framework release.
StarterA Recipe meant as a starting point. The CLI copies it once into a new directory, where it becomes your source.
Framework releaseA matched source/ directory (Recipes, docs, skills) and bundle/ directory (prepared packages), identified by an exact tag.
Prepared packageA prebuilt Framework package archive, stored in your application under vendor/smoothie/.
Framework skillsRelease-matched instructions for coding agents such as Codex and Claude Code.
AgentA Framework capability that runs inside your application. Not the same as a coding agent.

Responsibilities

Your applicationProduct source, data, secrets, policy, native targets, and process lifetimes.
Framework packagesCapability contracts for Service, Model, Agent, Tool, Worker, and Governance, plus adapters for HTTP hosts, model providers, and renderers.
Smoothie CLIDownloads and verifies releases, creates applications from Recipes, inspects projects, and runs native checks on request. Not needed to run the application.
Native toolsBun, Node, and your build tools install dependencies, compile, serve, and run the application.

Further reading

Choose a Starter compares the three Starters. Framework concepts explains capabilities, contracts, and adapters. The whisk/ui documentation covers interface components, styles, themes, and generative UI.