b00t

🥾 b00t - Universal Agentic Development Framework

"I am an agent. Tell me what I'm running on, what tools are available, what I'm allowed to do, what goals I should optimize for, and where the boundaries are." —ChatGPT (TL;DR b00t agent perspective)

b00t is an agentic hive operating system that unlocks AI agents with Neo-like powers in cyberspace. It's a context-aware development framework that bridges the gap between AI models and real-world tooling, enabling agents to maximize their capabilities through intelligent abstraction and unified tool discovery.

⚡ Quick Examples

# Install b00t (one-liner)
curl -fsSL https://raw.githubusercontent.com/elasticdotventures/_b00t_/main/install.sh | sh

# Install tools with automatic dependency resolution
b00t cli install fastmcp          # Installs python → uv → fastmcp (DAG-aware)
b00t cli install rust             # Install Rust toolchain
b00t cli check python             # Check if Python is installed

# Learn about available tools
b00t learn rust                   # Load Rust development context
b00t learn docker                 # Container orchestration knowledge

# Record and retrieve tribal knowledge
b00t lfmf rust "cargo build conflict: Unset CONDA_PREFIX before cargo to avoid PyO3 linker errors"
b00t advice rust "PyO3"           # Get contextual debugging advice

# MCP server integration
b00t mcp install browser-use claudecode    # Install MCP server with deps
b00t mcp list                              # List available MCP servers

# Model management
b00t model list                   # Show available AI models
b00t model download llava         # Download model weights
b00t model serve llava            # Launch vLLM server

🚀 Quick Install

🌟 Minimal Installation (Recommended - pkgx)

The fastest, cleanest way to install b00t - 4 MiB vs 1 GB toolchain:

# Install pkgx (one-time setup)
curl -Ssf https://pkgx.sh | sh

# Run b00t immediately (auto-downloads on first use)
pkgx b00t-cli --version

# Or install permanently to ~/.local/bin
pkgx +b00t-cli
b00t-cli --version

Why pkgx?

• ✅ Minimal footprint: 4 MiB binary vs 1 GB Rust toolchain
• ✅ Zero pollution: Isolated in ~/.pkgx, no system-wide changes
• ✅ Instant availability: Run without installation
• ✅ Perfect for AI agents: Fast bootstrap, ephemeral usage
• ✅ Auto-updates: Automatically tracks GitHub releases

Universal Installation (Classic Method)

One-liner that works everywhere:

curl -fsSL https://raw.githubusercontent.com/elasticdotventures/_b00t_/main/install.sh | sh

This universal installer:

• ✅ Prefers pkgx for minimal installation (prompts if not installed)
• ✅ Auto-detects your platform (Linux x86_64/aarch64/armv7, macOS)
• ✅ Downloads optimized binaries from GitHub releases
• ✅ Falls back to container mode if binaries unavailable
• ✅ Configures your shell automatically (bash/zsh/fish)
• ✅ Sets up PATH and aliases for immediate use

Alternative Installation Methods

# Install from crates.io (coming soon)
cargo install b00t-cli

# Or install from source
git clone https://github.com/elasticdotventures/_b00t_.git
cd _b00t_ && cargo install --path b00t-cli

# Run latest b00t container
docker pull ghcr.io/elasticdotventures/_b00t_:latest
docker run --rm -it -v $(pwd):/workspace ghcr.io/elasticdotventures/_b00t_:latest

# Or use the container wrapper (installed via universal script)
b00t status  # Automatically uses container if no native binary

# Coming soon - Homebrew tap in development
brew tap elasticdotventures/b00t
brew install b00t

# Ubuntu/Debian (coming soon)
curl -fsSL https://pkg.b00t.dev/gpg | sudo apt-key add -
echo "deb https://pkg.b00t.dev/apt stable main" | sudo tee /etc/apt/sources.list.d/b00t.list
sudo apt update && sudo apt install b00t

# Windows (Scoop - coming soon)
scoop bucket add b00t https://github.com/elasticdotventures/scoop-b00t
scoop install b00t

🎯 Verification & Quick Start

After installation, verify b00t is working:

# Check installation
b00t --version
b00t status

# Learn about your environment
b00t learn system      # Understand your platform
b00t learn rust        # Get Rust development context
b00t learn docker      # Container orchestration knowledge

# Start your first session
b00t session init --agent "your-name" --budget 10.00

🤖 Join the b00t Hive Mind