Local Install Skill

Build and install Agent Brain CLI and server locally with Python 3.11, Poetry, and uv.

115|21|Updated Dec 17, 2025
One-click install
npx skills add https://github.com/SpillwaveSolutions/agent-brain --skill local-install-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Local Install Skill
Source: https://github.com/SpillwaveSolutions/agent-brain/tree/main/.claude/skills/installing-local
Command: npx skills add https://github.com/SpillwaveSolutions/agent-brain --skill local-install-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires uv, poetry, pipx, python3.11, lsof.

What problem does it solve?

This Skill simplifies and accelerates the local installation of Agent Brain CLI and server, enabling rapid development and testing cycles without manual setup.

Core Features & Use Cases

  • One-command local build and install: compiles and installs both the CLI and server from source for fast iteration.
  • Environment readiness checks: validates prerequisites (Python 3.11, Poetry, uv) and cleans up stale processes for repeatable tests.
  • Deterministic local testing: ensures fresh toolchains and dependencies to reproduce issues reliably.
  • Use Case: A developer edits code in agent-brain-server or agent-brain-cli and needs a clean, local environment to verify changes quickly.

Quick Start

From the project root, run the local install process to build, install, and deploy the CLI/server locally.

Frequently Asked Questions about Local Install Skill

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

FAQPage Schema
How do I build and install the Agent Brain CLI and server locally for testing?

To build and install the Agent Brain CLI and server locally, run the local install process from the project root. This automates compiling and installing both components from source using shell scripts and the uv tool for rapid iteration.

Do I need Python 3.11 and Poetry to set up the local Agent Brain environment?

Yes, setting up the local Agent Brain environment requires Python 3.11, Poetry, and the uv tool. The skill validates these prerequisites during installation to ensure your development machine is ready.

What is the best way to automate a clean local build after editing Agent Brain server code?

Automating a clean local build after editing Agent Brain server code is best done by running the local install skill. It cleans up stale processes using lsof and builds fresh wheels to ensure deterministic local testing.

Why does my local Agent Brain testing fail with stale processes or dirty environments?

Local Agent Brain testing fails with stale processes because previous instances may occupy required ports. The skill resolves this by performing environment readiness checks and cleaning up stale processes before installing fresh dependencies.

Can I use uv instead of pipx to install the Agent Brain CLI from a local build?

Yes, you can use uv to install the Agent Brain CLI from a local build. The skill builds wheels and installs them via uv, while pipx is also listed as a dependency for managing the local installation environment.