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 assistant | DreamCode chat | |
|---|---|---|
| Where | AI Assistant dock, bottom-right of the 3D editor | 💬 Chat column inside DreamCode |
| Edits | The 3D scene directly (adds, moves, resizes, removes components) | Your DreamCode program, then builds it |
| Best for | Targeted edits: “put a sofa in the living room” | Whole-house changes: “add a second floor with two bedrooms” |
| Undo | Ctrl/⌘ Z in the editor | “↶ Undo this change” in the chat, or Ctrl/⌘ Z |
Set up your AI key#
- Get a Groq key
Create a free API key at console.groq.com.
- 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.
| Model | Use it when |
|---|---|
openai/gpt-oss-120b | Default — fast and recommended. |
llama-3.3-70b-versatile | Slower, more capable. |
llama-3.1-8b-instant | Fastest, for small edits. |
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:
- Checked
It’s compiled in the browser first. If it has errors, they’re sent back to the AI once automatically to fix.
- Applied and built
The code replaces yours and the house rebuilds — and if a
.dreamfile is linked, it’s saved there too. - 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#
| Message | What 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 up | Add your key on /settings/ai. |
| Your AI key was rejected by Groq | The key is invalid, revoked or lacks the selected model — replace it in AI settings. |
| …hit its rate limit / too large | Wait a minute, or ask for a smaller change. |
| The AI server doesn't support DreamCode yet | The server is older than the DreamCode chat — deploy the latest DreamHome API. |
Prefer your own AI tools? Connect Claude Code instead.