What is the difference between path-deps and PyPI restoration?

Using --use-path-deps configures the CLI to depend on the local server source for rapid development, while --restore-pypi switches back to standard package versions for production releases.

Why must I delete the marketplace cache after a local install?

The marketplace cache often stores stale plugin versions or invalid flags. Deleting it ensures that Claude picks up the fresh local build rather than an outdated cached version.

How do I perform a completely fresh reset of the environment?

You can use the provided removal script with the --zero-state flag. This stops all servers, uninstalls tools, clears caches, and removes all runtime state for a clean test environment.

Why is Python 3.11 specifically required for this skill?

Python 3.11 is required to ensure compatibility with ChromaDB, which is a core component of the Agent Brain RAG system. Newer versions like Python 3.12+ currently face build failures with these dependencies.

Agent Brain Local Development Suite

Name: Agent Brain Local Development Suite
Author: SpillwaveSolutions

bySpillwaveSolutions

•

Deployment & DevOps

Automates the local building, installation, and environment management for the Agent Brain CLI and RAG server.

The Local Install skill provides a comprehensive workflow for developers to build and deploy the Agent Brain RAG system in a local environment. It streamlines complex dependency management using uv and poetry, enforces strict Python 3.11 compatibility for ChromaDB stability, and includes robust cleanup routines to prevent stale code execution. This skill is essential for rapid iteration, allowing developers to test local changes, manage plugin caches, and ensure a consistent source of truth across private RAG instances.

Key Features

01Dynamic dependency toggling between local path and PyPI versions

02Aggressive process termination and port cleanup for reliable restarts

03Python 3.11 compatibility verification for ChromaDB support

04Automated plugin deployment and marketplace cache management

0547 GitHub stars

06Automated multi-package build process for CLI and Server components

Use Cases

01Configuring a fresh development environment for private RAG systems

02Deploying and verifying custom Claude plugins in a local sandbox

03Testing local code changes in the Agent Brain server or CLI components

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add spillwavesolutions/agent-brain installing-local

For use in Claude.ai and ChatGPT

Download Skill