Skip to content

Latest commit

 

History

2,449 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SYNAPSE

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

Latest release CI MIT license

Install · First session · JEV key setup · Help · What's new

Start here

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.

  1. Save your scene, close Houdini, and follow source installation.
  2. Restart Houdini. Open New Pane Tab → Synapse.
  3. Open Connect models. Choose a provider and model; add its key if needed.
  4. 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.

Your first build

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
Loading

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.

Find the right control

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.

Three ways to stop

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.

What's ready

  • 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

When you get stuck

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 it work

Play the SYNAPSE tool demonstration

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

How SYNAPSE remembers

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.

License

MIT. Bundled Moneta retains its separate proprietary terms.

Patent applications pending on the USD cognitive-state substrate, digital injection, and predictive lighting — see PATENTS.

About

Artist-controlled AI assistance inside Houdini. Build editable node networks, connect local or cloud models, and explore checked suggestions with optional project memory.

Topics

Resources

Contributing

Security policy

Stars

10 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages