Getting started
Node 24 or newer, and pnpm (corepack enable gives the version packageManager names in package.json). Chrome for command-line renders.
pnpm installpnpm test # the engine, the operations, the format, the interop, the editor's logic, the Worker, the API and the desktop storagepnpm typecheck
pnpm dev # the editor on http://localhost:8787/ (local Worker, projects in .wrangler/state)pnpm site # the landing page and the docs (Astro) on http://localhost:4321/pnpm desktop:dev # the editor as a native window (Tauri 2), projects in Documents/Trammepnpm dev rebuilds the editor on every change and runs the Worker locally (wrangler dev): R2 storage simulated on disk, no Cloudflare Access. It also starts the assistant’s companion, which pairs with this editor by itself (TRAMME_NO_COMPANION=1 to go without it). The home screen starts a film from words: describe it, add its material if there is any, pick a format, and the project opens in the studio with the assistant at work. A blank project, a video, a .tramme file, a Lottie animation and the examples are there too.
For the assistant with another local page, in a second terminal:
pnpm tramme agent # the companion: the agents of this machine on their own logins (`npx @qualris/tramme` outside the repository)then paste the token it prints in the editor (Assistant, settings). See The assistant.