🐉 houdini-agent-panel
An AI agent inside Houdini. One command to install, no terminal to keep open.
Ask for what you want in the scene. The agent has 189 Houdini tools through
fxhoudinimcp and works on the
.hip you have open — no ports to pick, no config to write.
⚡ Install
macOS · Linux
curl -fsSL https://raw.githubusercontent.com/MAY4VFX/houdini-agent-panel/main/scripts/install.sh | sh
Windows (PowerShell)
irm https://raw.githubusercontent.com/MAY4VFX/houdini-agent-panel/main/scripts/install.ps1 | iex
Already have uv?
uvx --from houdini-agent-panel python -m houdini_agent_panel install
Restart Houdini → Tab → Python Panels → Agent. 🎉
The installer finds every Houdini on the machine and installs into each one's
own Python — 20.5 ships 3.11, 22 ships 3.13, and pydantic's compiled core
means one shared tree for both is impossible.
🤖 Agents
Claude Agent · Codex · Gemini CLI · Grok Build · Kimi CLI · OpenCode
Pick one in the panel; only that one gets installed. Node comes bundled if your machine hasn't got it.
Two of them — Claude Agent and Codex — are ACP adapters published by the protocol project; the other four are the CLIs themselves with ACP built in.
The panel installs agents but never configures them. Providers, API keys and MCP servers stay in the agent's own files, exactly as in a terminal. An agent you already use will work here with nothing further to do.
🔑 Signing in
- Pick an agent — it installs and connects.
- Type
/loginand follow it. 🌐 - That's it. The panel stores no credentials and asks for none.
Some agents advertise their sign-in methods and get a proper sign-in screen
instead. OpenCode has no login at all: it reads a provider and a key from
~/.config/opencode/opencode.json.
⚙️ Settings
Install and update agents, pick what starts with the panel, point it at a
studio proxy and a corporate CA. Blank proxy fields inherit whatever the
machine already exports; localhost is never proxied.
🔒 Privacy
Telemetry is off by default. Scenes, prompts and paths are never
collected — docs/privacy.md.
🛠 Development
uv venv --python 3.11 .venv
uv pip install --python .venv/bin/python -e ".[dev]"
.venv/bin/python -m pytest -q
Tests never touch the network and never write outside tmp_path — enforced
by fixtures, not by discipline.
The UI runs without Houdini, with real widgets and a fake session, and restarts itself on every save:
.venv/bin/python -m houdini_agent_panel.dev_preview --watch
More commands:
python -m houdini_agent_panel install --dry-run # show the plan, change nothing
python -m houdini_agent_panel doctor # what was found, what's broken
python -m houdini_agent_panel uninstall --purge # remove, data folder included
📚 Docs
Design · Architecture · Verified facts about Houdini, ACP and fx
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for houdini-agent-panel 0.1.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| houdini_agent_panel-0.1.4.tar.gz | 577.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| houdini_agent_panel-0.1.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.1 MB
Release files / houdini_agent_panel-0.1.4.tar.gz
| Download URL | houdini_agent_panel-0.1.4.tar.gz |
|---|---|
| Size | 577.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
69e5a62d9f6078930692fa23d0bdb974150d65872e5348e401e8f745514fcecd
|
|
BLAKE2b-256 checksum How to use checksums |
24b18549c25858df604b550721f1ef6354c51aa0fc79b3ffd552e1d8e5349800
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.0
|
Release files / houdini_agent_panel-0.1.4-py3-none-any.whl
| Download URL | houdini_agent_panel-0.1.4-py3-none-any.whl |
|---|---|
| Size | 500.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4f683c38bfab62477769d37e67a24b62ddf537ee788e68622f867276aad2672b
|
|
BLAKE2b-256 checksum How to use checksums |
3151fc886396f8ffaaa687d572a936f5fa74f2a3028d45d70d65467b6f689ec2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.0
|
