Your AI assistant inside Houdini.
Describe a task. Inspect the nodes. Keep creative control.
v5.84.2 · Houdini 22.0.400 · Python 3.13 runtime
tags: v5.84.2 is Latest
Install · First session · JEV key setup · Help · What's new
Current release: source installation. The available Windows Setup is older, v5.75.2. It does not include the latest panel, JEV or SideFX library changes.
The current validation target is Windows + Houdini 22.0.400, using Houdini's bundled Python 3.13. See installation requirements and steps.
- Save your scene, close Houdini, and follow source installation.
- Restart Houdini. Open New Pane Tab → Synapse.
- Open Connect models. Choose a provider and model; add its key if needed.
- For node creation, select Build and edit networks. Choose Check connection → Use this model.
Using Ollama? Start its service first. Connect starts the separate Houdini bridge; Doctor checks the setup without a model.
In a scratch scene, send:
make a box
Inspect the nodes, change a parameter, then try Undo.
flowchart LR
accTitle: From a prompt to an inspected result
accDescr: You describe a task. Your selected model uses permitted tools. SYNAPSE shows the result or a reason it could not run. You inspect the scene.
U["Describe a task"] --> M["Model +<br/>permitted tools"]
M --> R["Result or<br/>reason shown"]
R --> I["Inspect in<br/>Houdini"]
classDef default fill:#282828,stroke:#555555,color:#E5E5E5
classDef artist fill:#87CDA5,stroke:#87CDA5,color:#1F1F1F
classDef synapse fill:#FF7457,stroke:#FF7457,color:#1F1F1F
class U,I artist
class M synapse
Undo covers a recorded operation. It does not reverse a whole conversation or files written to disk. A failed build can leave partial nodes until you deliberately undo them.
The normal panel worker blocks node deletion, arbitrary Python/VEX, rendering, exporting and PDG cooking. See tool policy and execution boundaries.
| I want to… | Open or use… |
|---|---|
| Change the generation model | The model name at the top, or Connect models. |
| Add my JEV / TypeSafe key | Connect models → JEV / TypeSafe key setup → Save session key. Setup guide. |
| Make more room for my prompt | Drag Resize above the input box. |
| Find an action | Commands below the input box. |
Import a Marble world or Gaussian .ply |
World Labs beside Cloud relay. Import flow and limits. |
| Connect the SideFX help library | Follow Build and connect; Scout searches the published local index. |
| Check a connection | Connect, then Doctor. |
Saving a JEV key keeps it in memory until Houdini closes. It does not enable JEV, verify the key or grant data permission. The setup guide walks through those separate controls.
| Control | What it reaches | Limit |
|---|---|---|
| Stop | The panel's current turn. | Does not prove an active cook or render has stopped. |
| Cancel cook · overflow menu | One known cooking node. | Unavailable when SYNAPSE cannot identify the node. |
| Emergency halt · overflow menu | Cooking TOP networks under /tasks, /obj, /stage, /out; captures a session report. |
Background renders are reported, not stopped. |
- Network work: build and inspect through permitted tools; keep the result editable in Houdini.
- Model choice: Claude, Gemini, NVIDIA Nemotron, Ollama and custom OpenAI-compatible endpoints. Tool support varies.
- Optional JEV assistance: rank selected-network actions or measure routing. Your generation model stays selected.
- Local knowledge: SideFX library, project memory and checked lookdev suggestions.
Current limits · Latest release notes · Changelog
| What you see | Try this first |
|---|---|
| No Synapse pane | Restart Houdini, then verify installation. |
| Missing Ollama models | Start Ollama; reopen Connect models → Check connection. |
| Unsure where the TypeSafe key goes | JEV key setup. |
| No saved suggestion | Read its reason. A checked record, matching version and project memory owner are required. |
| Build running away | Use Cancel cook or Emergency halt, then inspect the scene. |
Report a bug · First-session walkthrough
Watch the recorded demonstration on Vimeo →
For developers: architecture, checks and memory
137 tools, two paths. The registry count comes from TOOL_DEFS, checked by tool-count tests.
Panel requests prefer HTTP /mcp; its ordinary mutations use the execution bridge. Reads, farm controls and Doctor route separately. The configured stdio client forwards Houdini calls over WebSocket /synapse to direct handlers. Those paths have different policy and evidence boundaries.
Execution diagrams and limits · External MCP setup · Source development and tests
Configured memory and scene/project notes supply recalled context. Recall is advice; it does not authorize a scene action. Moneta's USD mirror is an inspection view, not the storage owner. Missing services and unknown outcomes remain visible.
Storage and recall diagram · Optional memory LOOP · Saved suggestions
CI covers stock Python on Linux and macOS. Native Houdini behavior and Windows installer qualification are separate checks. See each release's evidence before relying on it.
MIT. Bundled Moneta retains its separate proprietary terms.
Patent applications pending on the USD cognitive-state substrate, digital injection, and predictive lighting — see PATENTS.
