webber/README.md

Webber - Multi-Agent AI Development System

A Claude Code-inspired development assistant powered by local LLMs via Ollama.

Features

• 3 Agents - Explore (read-only), Plan (architecture), Task (orchestrator)
• 8 Tools - File read/write/edit, glob, grep, bash, web search
• Conversations - Multi-turn memory with context summarization
• Streaming - Real-time response display
• Self-hosted - Runs on your own hardware with Ollama

Structure

This is a monorepo containing three subprojects:

Directory	Description
webber-api/	FastAPI backend server with agent orchestration
webber-cli/	Command-line client for interacting with the API
webber-sandbox/	Test project for functional testing

Additional Directories

Directory	Description
sandbox-templates/	Reusable project templates for the sandbox
.gitea/workflows/	CI/CD workflows for releases

Quick Start

1. Start the API Server

cd webber-api
python3.12 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt -r requirements-dev.txt
./wakeup.sh

2. Set Up the CLI

cd webber-cli
python3.12 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pip install -e .

# Test connection
webber-cli status

3. Explore with Webber

# One-shot exploration
webber-cli explore "find all bugs in the code" -d /path/to/project

# Interactive chat
webber-cli chat -d /path/to/project

Available Tools

Tool	Description
read_file	Read file contents with line numbers
glob_files	Find files by pattern
grep_content	Search file contents with regex
bash_readonly	Safe bash commands (ls, git status, etc.)
edit_file	Find-and-replace editing
write_file	Create/overwrite files
bash	Full bash with safety controls
web_search	Search web via SearXNG

Agents

Agent	Purpose	Tools
Explore	Fast codebase navigation, search	Read-only (glob, grep, read, bash_readonly)
Plan	Design implementation strategies	Read-only (same as Explore)
Task	Autonomous multi-step execution	All tools + spawn_agent

API Endpoints

# Stateless agent execution
POST /agents/run          # Execute agent, get response
POST /agents/stream       # Execute with SSE streaming
GET  /agents/             # List available agents

# Stateful conversations (multi-turn memory)
POST /conversations/              # Create conversation
GET  /conversations/              # List conversations
POST /conversations/{id}/messages # Add message, get agent response

Versioning

This project uses prefixed tags for independent release cycles:

• api/v0.4.0 - Triggers API Docker build and deployment
• cli/v0.1.0 - Triggers CLI installer build (future)

Requirements

• Python 3.12+
• Ollama running with gemma4:e2b model
• Docker (for production deployment)
• SearXNG (optional, for web search)

Documentation

• webber-api/AGENTS.md - API development guidelines
• webber-api/docs/COVERAGE.md - Feature coverage and roadmap
• webber-api/docs/architecture.md - System architecture
• webber-cli/README.md - CLI usage guide

License

MIT