Webber - Multi-Agent AI Development System

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

Features

• Explore Agent - Search, read, and understand codebases
• 8 Tools - File read/write, glob, grep, bash, web search
• 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

Versioning

This project uses prefixed tags for independent release cycles:

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

Requirements

• Python 3.12+
• Ollama running with mistral-nemo:latest 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