os-model-library-setup

Configure a Griptape Nodes library for an OS model with submodule, manifest, and advanced library file.

2|2|Updated Mar 26, 2025
One-click install
npx skills add https://github.com/griptape-ai/griptape-nodes-library-template --skill os-model-library-setup-griptape-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: os-model-library-setup
Source: https://github.com/griptape-ai/griptape-nodes-library-template/tree/main/.claude/skills/os-model-library-setup
Command: npx skills add https://github.com/griptape-ai/griptape-nodes-library-template --skill os-model-library-setup-griptape-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a Griptape Nodes library for an open-source model requires many coordinated manual steps: renaming template directories, adding git submodules, editing pyproject.toml, Makefile, .gitignore, and writing a manifest JSON and advanced library Python file. This Skill automates that entire transformation from a spec file. ## Core Features & Use Cases - Template Transformation: Renames the example_nodes_template directory, removes template example files, and updates init.py, pyproject.toml, Makefile, and .gitignore to match the new library. - Submodule Management: Adds the OS model repo as a pinned git submodule and generates an advanced library file that installs dependencies from the submodule's requirements.txt at load time, with commit-aware reinstall detection. - Manifest Generation: Builds griptape-nodes-library.json with the latest engine version, torch dependencies, GPU resource requirements, and categories derived from the spec. - Use Case: Given a spec file describing the SAM3 model, run this Skill to produce a complete griptape-nodes-library-sam3 package with the sam3 submodule pinned to a release tag and a working SAM3LibraryAdvanced loader. ## Quick Start Run the os-model-library-setup skill with the path to my OS model spec file to scaffold the full Griptape Nodes library.

Frequently Asked Questions about os-model-library-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a Griptape Nodes library for an open-source model?

Provide a spec file describing the model's library name, package directory, repo URL, dependencies, and GPU requirements. The skill renames the template directory, adds the model repo as a pinned git submodule, updates configuration files, and generates the manifest and advanced library file.

How do I add a git submodule to a Griptape Nodes library?

Run git submodule add with the model repo URL inside the package directory, then pin it to a release tag or the current HEAD commit. The pinned SHA guarantees reproducible installs, and the advanced library reinstalls the package when the pinned commit changes.

What if the OS model submodule is not pip-installable?

For submodules without setup.py or pyproject.toml, the advanced library uses a sys.path insertion variant instead of pip install. The commit sentinel becomes the sole install signal, and sys.path is re-applied on every library load since it does not persist across engine restarts.

Should griptape-nodes-engine be added to pyproject dependencies?

No. The engine is the host that loads the library, so listing it as a runtime dependency installs a second engine that can shadow the running one. Keep it in the dev dependency group and declare the required version via engine_version in the manifest JSON.

Why does pip fail with 'No module named torch' when installing model requirements?

Packages like auto_gptq and flash-attn need torch at build time, but pip's build isolation hides the venv's packages. The generated library installs torch first via the manifest's pip_dependencies and uses --no-build-isolation when installing the submodule's requirements.txt.