houdini-agent-panel 0.1.0__tar.gz

houdini_agent_panel-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MAY4VFX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

houdini_agent_panel-0.1.0/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: houdini-agent-panel
+Version: 0.1.0
+Summary: Панель-чат с ACP-агентом внутри SideFX Houdini поверх fxhoudinimcp
+Author: MAY4VFX
+License: MIT
+Project-URL: Homepage, https://github.com/MAY4VFX/houdini-agent-panel
+Project-URL: Issues, https://github.com/MAY4VFX/houdini-agent-panel/issues
+Keywords: houdini,vfx,acp,agent,mcp
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
+Requires-Python: <3.15,>=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: agent-client-protocol<0.13,>=0.12
+Requires-Dist: fxhoudinimcp>=2.10
+Requires-Dist: certifi
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
+Requires-Dist: PySide6>=6.5; extra == "dev"
+Dynamic: license-file
+
+# houdini-agent-panel
+
+Панель-чат с AI-агентом внутри SideFX Houdini. Ставится одной командой, агент
+поднимается сам — ни терминала, ни портов, ни правки конфигов.
+
+> Статус: v1 в сборке. Дизайн — [`docs/design.md`](docs/design.md), контракт модулей —
+> [`docs/architecture.md`](docs/architecture.md), проверенные факты о внешних API —
+> [`docs/facts/`](docs/facts/).
+
+## Зачем
+
+Чтобы сегодня пользоваться агентом со сценой Houdini, нужен открытый терминал с `claude`
+и настройка MCP руками. Художник этого не сделает.
+
+Панель — надстройка над [fxhoudinimcp](https://github.com/healkeiser/fxhoudinimcp)
+(189 инструментов работы со сценой поверх официального `hwebserver` Houdini). Мы не
+пишем ни агента, ни инструменты — только ACP-клиент и инсталлятор, связывающие готовое.
+
+## Агенты
+
+Из официального [реестра ACP](https://github.com/agentclientprotocol/registry):
+Claude Agent, Codex, Gemini CLI, Grok Build, Kimi CLI, OpenCode — плюс «Свой агент»
+для всего остального. Ставится только выбранный, а не все сразу. Node, если нужен,
+панель приносит с собой.
+
+Свои и удалённые модели подключаются как модель внутри OpenCode: ACP работает только
+через stdio, поэтому агент всегда локальный, а эндпоинт модели может быть где угодно.
+
+## Установка
+
+Одной командой, одинаково на macOS, Linux и Windows:
+
+```bash
+uvx --from houdini-agent-panel python -m houdini_agent_panel install --agents opencode
+```
+
+Она находит все установленные Houdini, ставит панель в Python каждой из них,
+прописывает пакет и качает выбранного агента. В систему ничего не попадает:
+`uvx` запускает инсталлятор и уходит.
+
+Нет `uv`? Он ставится тоже одной командой и не требует прав root:
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh          # macOS, Linux
+powershell -c "irm https://astral.sh/uv/install.ps1 | iex"  # Windows
+```
+
+В репозитории лежат `scripts/install.sh` и `scripts/install.ps1` — они делают
+оба шага сразу и пригодятся, когда репозиторий станет публичным и их можно
+будет вызывать через `curl … | sh`.
+
+Перезапустить Houdini → панель появится в меню панелей (Tab → Python Panels → Agent).
+
+Инсталлятор находит на машине все установленные Houdini и для каждой ставит панель
+**в её собственный Python**. Это не прихоть: `pydantic` тащит скомпилированное ядро, а у
+Houdini 20.5 внутри Python 3.11 и у Houdini 22 — 3.13, так что одно общее дерево
+зависимостей на обе версии физически невозможно. Подробности — в
+[`docs/architecture.md`](docs/architecture.md) §0.
+
+Полезное:
+
+```bash
+python -m houdini_agent_panel install --dry-run   # показать план, ничего не менять
+python -m houdini_agent_panel doctor              # что нашлось и что сломано
+python -m houdini_agent_panel uninstall --purge   # убрать вместе с папкой данных
+```
+
+Ставится из локально собранного колеса — `--find-links dist`. Полностью офлайн —
+добавить `--offline` и положить в ту же папку колёса всех зависимостей.
+
+## Приватность
+
+Телеметрия выключена по умолчанию и включается только явно. Что собирается и что не
+собирается никогда — [`docs/privacy.md`](docs/privacy.md).
+
+## Разработка
+
+```bash
+uv venv --python 3.11 .venv            # 3.11 — нижняя поддерживаемая версия (Houdini 20.5)
+uv pip install --python .venv/bin/python -e ".[dev]"
+.venv/bin/python -m pytest -q
+```
+
+Тесты не ходят в сеть и не пишут за пределы `tmp_path` — это обеспечено автофикстурами
+в `tests/conftest.py`, а не дисциплиной.
+
+## Лицензия
+
+MIT

houdini_agent_panel-0.1.0/README.md

@@ -0,0 +1,89 @@
+# houdini-agent-panel
+
+Панель-чат с AI-агентом внутри SideFX Houdini. Ставится одной командой, агент
+поднимается сам — ни терминала, ни портов, ни правки конфигов.
+
+> Статус: v1 в сборке. Дизайн — [`docs/design.md`](docs/design.md), контракт модулей —
+> [`docs/architecture.md`](docs/architecture.md), проверенные факты о внешних API —
+> [`docs/facts/`](docs/facts/).
+
+## Зачем
+
+Чтобы сегодня пользоваться агентом со сценой Houdini, нужен открытый терминал с `claude`
+и настройка MCP руками. Художник этого не сделает.
+
+Панель — надстройка над [fxhoudinimcp](https://github.com/healkeiser/fxhoudinimcp)
+(189 инструментов работы со сценой поверх официального `hwebserver` Houdini). Мы не
+пишем ни агента, ни инструменты — только ACP-клиент и инсталлятор, связывающие готовое.
+
+## Агенты
+
+Из официального [реестра ACP](https://github.com/agentclientprotocol/registry):
+Claude Agent, Codex, Gemini CLI, Grok Build, Kimi CLI, OpenCode — плюс «Свой агент»
+для всего остального. Ставится только выбранный, а не все сразу. Node, если нужен,
+панель приносит с собой.
+
+Свои и удалённые модели подключаются как модель внутри OpenCode: ACP работает только
+через stdio, поэтому агент всегда локальный, а эндпоинт модели может быть где угодно.
+
+## Установка
+
+Одной командой, одинаково на macOS, Linux и Windows:
+
+```bash
+uvx --from houdini-agent-panel python -m houdini_agent_panel install --agents opencode
+```
+
+Она находит все установленные Houdini, ставит панель в Python каждой из них,
+прописывает пакет и качает выбранного агента. В систему ничего не попадает:
+`uvx` запускает инсталлятор и уходит.
+
+Нет `uv`? Он ставится тоже одной командой и не требует прав root:
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh          # macOS, Linux
+powershell -c "irm https://astral.sh/uv/install.ps1 | iex"  # Windows
+```
+
+В репозитории лежат `scripts/install.sh` и `scripts/install.ps1` — они делают
+оба шага сразу и пригодятся, когда репозиторий станет публичным и их можно
+будет вызывать через `curl … | sh`.
+
+Перезапустить Houdini → панель появится в меню панелей (Tab → Python Panels → Agent).
+
+Инсталлятор находит на машине все установленные Houdini и для каждой ставит панель
+**в её собственный Python**. Это не прихоть: `pydantic` тащит скомпилированное ядро, а у
+Houdini 20.5 внутри Python 3.11 и у Houdini 22 — 3.13, так что одно общее дерево
+зависимостей на обе версии физически невозможно. Подробности — в
+[`docs/architecture.md`](docs/architecture.md) §0.
+
+Полезное:
+
+```bash
+python -m houdini_agent_panel install --dry-run   # показать план, ничего не менять
+python -m houdini_agent_panel doctor              # что нашлось и что сломано
+python -m houdini_agent_panel uninstall --purge   # убрать вместе с папкой данных
+```
+
+Ставится из локально собранного колеса — `--find-links dist`. Полностью офлайн —
+добавить `--offline` и положить в ту же папку колёса всех зависимостей.
+
+## Приватность
+
+Телеметрия выключена по умолчанию и включается только явно. Что собирается и что не
+собирается никогда — [`docs/privacy.md`](docs/privacy.md).
+
+## Разработка
+
+```bash
+uv venv --python 3.11 .venv            # 3.11 — нижняя поддерживаемая версия (Houdini 20.5)
+uv pip install --python .venv/bin/python -e ".[dev]"
+.venv/bin/python -m pytest -q
+```
+
+Тесты не ходят в сеть и не пишут за пределы `tmp_path` — это обеспечено автофикстурами
+в `tests/conftest.py`, а не дисциплиной.
+
+## Лицензия
+
+MIT

houdini_agent_panel-0.1.0/pyproject.toml

@@ -0,0 +1,64 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "houdini-agent-panel"
+version = "0.1.0"
+description = "Панель-чат с ACP-агентом внутри SideFX Houdini поверх fxhoudinimcp"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10,<3.15"
+authors = [{ name = "MAY4VFX" }]
+keywords = ["houdini", "vfx", "acp", "agent", "mcp"]
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Intended Audience :: End Users/Desktop",
+    "Topic :: Multimedia :: Graphics :: 3D Modeling",
+]
+dependencies = [
+    "agent-client-protocol>=0.12,<0.13",
+    "fxhoudinimcp>=2.10",
+    # Python, который приносит Houdini, собран без связки корневых сертификатов:
+    # HTTPS оттуда падает с CERTIFICATE_VERIFY_FAILED. Зависимость прямая, а не
+    # транзитивная через mcp/httpx, потому что без неё у панели молча отваливается
+    # вся работа с сетью (см. network.ssl_context).
+    "certifi",
+]
+
+[project.urls]
+Homepage = "https://github.com/MAY4VFX/houdini-agent-panel"
+Issues = "https://github.com/MAY4VFX/houdini-agent-panel/issues"
+
+[project.scripts]
+houdini-agent-panel = "houdini_agent_panel.__main__:main"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8",
+    "pytest-asyncio>=0.24",
+    "PySide6>=6.5",
+]
+
+[tool.setuptools]
+package-dir = { "" = "python" }
+
+[tool.setuptools.packages.find]
+where = ["python"]
+include = ["houdini_agent_panel*"]
+
+[tool.setuptools.package-data]
+houdini_agent_panel = ["houdini/**/*", "data/*.json"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+filterwarnings = ["ignore::DeprecationWarning"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"

houdini_agent_panel-0.1.0/python/houdini_agent_panel/__init__.py

@@ -0,0 +1,5 @@
+"""Панель-чат с ACP-агентом внутри SideFX Houdini поверх fxhoudinimcp."""
+
+__version__ = "0.1.0"
+
+__all__ = ["__version__"]

houdini_agent_panel-0.1.0/python/houdini_agent_panel/__main__.py

@@ -0,0 +1,112 @@
+"""CLI инсталлятора: ``python -m houdini_agent_panel <команда>``."""
+
+from __future__ import annotations
+
+import argparse
+import sys
+from typing import Sequence
+
+from . import houdini_package
+from . import install as install_mod
+from . import paths
+
+
+def _split_agents(value: str | None) -> list[str]:
+    if not value:
+        return []
+    return [item.strip() for item in value.split(",") if item.strip()]
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="houdini_agent_panel",
+        description="Установка и диагностика панели-агента для Houdini.",
+    )
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    install_parser = subparsers.add_parser(
+        "install", help="Поставить панель в найденные на машине Houdini"
+    )
+    install_parser.add_argument(
+        "--houdini-dir",
+        default=None,
+        help="Явный путь к <prefs>/packages вместо автопоиска по всем версиям на машине",
+    )
+    install_parser.add_argument(
+        "--agents",
+        default=None,
+        help="Агенты через запятую, например claude,codex. Без флага не ставится ни один",
+    )
+    install_parser.add_argument(
+        "--find-links",
+        default=None,
+        help="Локальная директория с колёсами: искать пакеты сначала там",
+    )
+    install_parser.add_argument(
+        "--offline",
+        action="store_true",
+        help="Не ходить на PyPI вообще (нужен --find-links со всеми зависимостями)",
+    )
+    install_parser.add_argument(
+        "--skip-deps",
+        action="store_true",
+        help="Не ставить зависимости панели в Houdini-Python, только package json",
+    )
+    install_parser.add_argument(
+        "--dry-run",
+        action="store_true",
+        help="Только показать план, ничего не менять на диске",
+    )
+
+    uninstall_parser = subparsers.add_parser("uninstall", help="Убрать панель из Houdini")
+    uninstall_parser.add_argument("--houdini-dir", default=None)
+    uninstall_parser.add_argument(
+        "--purge", action="store_true", help="Также снести папку данных панели целиком"
+    )
+    uninstall_parser.add_argument("--dry-run", action="store_true")
+
+    subparsers.add_parser(
+        "houdini-package", help="Напечатать package json панели и куда его класть"
+    )
+    subparsers.add_parser("doctor", help="Проверить, что из установки нашлось на машине")
+
+    return parser
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+
+    if args.command == "install":
+        return install_mod.install(
+            houdini_dir=args.houdini_dir,
+            agents=_split_agents(args.agents),
+            find_links=args.find_links,
+            offline=args.offline,
+            skip_deps=args.skip_deps,
+            dry_run=args.dry_run,
+        )
+
+    if args.command == "uninstall":
+        return install_mod.uninstall(
+            houdini_dir=args.houdini_dir,
+            purge=args.purge,
+            dry_run=args.dry_run,
+        )
+
+    if args.command == "houdini-package":
+        target = paths.deps_dir()
+        payload = houdini_package.package_json(deps=target, installer_python=sys.executable)
+        print(f"Куда класть: <HOUDINI_USER_PREF_DIR>/packages/{houdini_package.PACKAGE_NAME}")
+        print(payload)
+        return 0
+
+    if args.command == "doctor":
+        return install_mod.doctor()
+
+    parser.error(f"неизвестная команда: {args.command}")
+    return 2  # parser.error сам завершает процесс, эта строка — для тестов на моке
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())