Documentation menu
AI

AI assistants

The scene assistant, the DreamCode chat and your own Groq key.

DreamHome has two AI assistants. Both run through the DreamHome server, so your AI key never reaches the browser, and everything they change is a normal, undoable edit.

Scene assistantDreamCode chat
WhereAI Assistant dock, bottom-right of the 3D editor💬 Chat column inside DreamCode
EditsThe 3D scene directly (adds, moves, resizes, removes components)Your DreamCode program, then builds it
Best forTargeted edits: “put a sofa in the living room”Whole-house changes: “add a second floor with two bedrooms”
UndoCtrl/⌘ Z in the editor“↶ Undo this change” in the chat, or Ctrl/⌘ Z

Set up your AI key#

  1. Get a Groq key

    Create a free API key at console.groq.com.

  2. Save it in DreamHome

    Open AI in the top navigation (/settings/ai), paste the key and pick a model. The key is checked against Groq before it’s saved, then stored encrypted — the page only ever shows a masked hint.

ModelUse it when
openai/gpt-oss-120bDefault — fast and recommended.
llama-3.3-70b-versatileSlower, more capable.
llama-3.1-8b-instantFastest, for small edits.
Note
Some deployments also provide a shared server key, used when you haven’t saved your own. The server limits each user to 15 assistant requests a minute, and Groq’s free tier caps tokens per minute — if you hit a rate limit, wait a moment or ask for something smaller.

Scene assistant#

Each message sends the conversation plus a compact snapshot of the current scene. The assistant replies with operations (add / change / move / remove components) or a whole new plan, which the editor validates and applies through the same command system as manual edits.

  • “Add a 4 m wall facing north.”
  • “Put a sofa and a table in the living room.”
  • “What’s in the scene?”

DreamCode chat#

The chat sends your request together with your current DreamCode. The AI returns the complete updated program, which goes through four steps:

  1. Checked

    It’s compiled in the browser first. If it has errors, they’re sent back to the AI once automatically to fix.

  2. Applied and built

    The code replaces yours and the house rebuilds — and if a .dream file is linked, it’s saved there too.

  3. Explained

    The reply says what changed, with an ↶ Undo this change button.

Prompts that work well

  • “Add a second floor with two bedrooms and a bathroom, and stairs from the living room.”
  • “Make the kitchen 5 m wide and give it two 15 A plugs.”
  • “Use a gable roof and add a window to every bedroom.”
  • Casual or misspelled requests are fine — “add stare case to go up floor” works.

The AI knows the language, the floor and stair rules and the platform’s limits, so if you ask for something DreamCode can’t do yet (curved walls, balconies) it says so and does the closest thing.

Troubleshooting#

MessageWhat to do
Can't reach the AI server at …The DreamHome API is unreachable — check your connection; when running locally, make sure the backend is running.
No AI key is set upAdd your key on /settings/ai.
Your AI key was rejected by GroqThe key is invalid, revoked or lacks the selected model — replace it in AI settings.
…hit its rate limit / too largeWait a minute, or ask for a smaller change.
The AI server doesn't support DreamCode yetThe server is older than the DreamCode chat — deploy the latest DreamHome API.

Prefer your own AI tools? Connect Claude Code instead.