Skip to main content

​
Clone and run

​
What this lets you do

Install the open-source image infrastructure and keep conversations, jobs, assets, and provider keys on your machine.

​
What you need

  • Git
  • Python 3.11 or later
  • uv
  • Node.js 22.12 or later
  • pnpm 10
  • A current browser

​
Steps

​
1. Start the runtime

The first release is clone-and-run. PyPI and npm publication are separate release actions and are not required for the beta.

​
2. Stop and resume

Press Ctrl+C in the terminal that runs DreamLayer. Start it again with ./dreamlayer. Conversations and durable job state remain in the local data directory. A job interrupted by a runtime restart is recovered or moved to a visible terminal failure state.

​
Confirm it worked

The launcher prints a loopback URL, DreamLayer WebUI opens there, and a sample job reaches a visible terminal state.

​
Common errors

  • If uv, Node.js, or pnpm is missing, install the prerequisite and repeat step 1.
  • If the browser cannot connect, use the exact loopback URL printed by the launcher.
  • If startup fails after an upgrade, run ./dreamlayer doctor --json and keep the sanitized output.

​
Troubleshooting

The runtime binds to loopback, validates Host and Origin, and gives the browser a local session. Provider keys stay in the local server process. Do not weaken these controls to work around a setup problem. See Troubleshooting.

​
Next steps

The runtime binds to loopback, validates Host and Origin, and gives the browser a local session. Provider keys stay in the local server process.