Structure webber into three independent subprojects: - webber-api/: FastAPI backend server with all agent code - webber-cli/: Standalone CLI client (renamed from cli/ to webber_cli/) - webber-sandbox/: Test project for functional testing Key changes: - Each subproject has its own .venv (Python 3.12+) - Added sandbox.sh for managing test project templates - Created sandbox-templates/ with calculator-cli and empty starter - Updated CI/CD for prefixed tags (api/v*, cli/v*) - Added comprehensive AGENTS.md with operational instructions - Added gitignore filtering to glob and grep tools - Created pyproject.toml for each subproject Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1.8 KiB
1.8 KiB
Webber - Multi-Agent AI Development System
A Claude Code-inspired development assistant powered by local LLMs via 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. Load a Sandbox Project
# From repo root
./sandbox.sh list
./sandbox.sh load calculator-cli
cd webber-sandbox
python3.12 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
4. Explore with Webber
cd webber-cli
webber-cli explore "find all bugs in the code" -d ../webber-sandbox
Versioning
This project uses prefixed tags for independent release cycles:
api/v0.3.0- Triggers API Docker build and deploymentcli/v0.1.0- Triggers CLI installer build (future)
Requirements
- Python 3.12+
- Ollama running with
mistral-nemo:latestmodel - Docker (for production deployment)
Documentation
webber-api/AGENTS.md- API development guidelineswebber-api/docs/- Architecture and coverage docswebber-cli/README.md- CLI usage guide
License
MIT