Local-Claude-Brain 🧠

A local, zero-cost, multi-agent Python MVP demonstrating SaaS orchestration running entirely locally via Ollama using the qwen3.5:4b model.

Project Description

Local-Claude-Brain demonstrates a fully automated, local multi-agent architecture (Planner -> Executor). This project breaks down a Python refactoring task into granular steps: a Planner Agent formulates a step-by-step refactoring approach, and an Executor Agent implements those exact steps to transform bad code into high-quality code. This architecture operates autonomously without incurring any third-party API costs.

Tech Stack

• Language: Python 3.x
• AI Provider: Ollama (Local)
• LLM: Qwen3.5:4b (qwen3.5:4b)
• Libraries: ollama, rich

Prerequisites

1. Install Ollama: Download and install Ollama from ollama.com.
2. Pull the Model: Open your terminal and pull the Qwen3.5 model. Keep the Ollama app running in the background.

   ollama run qwen3.5:4b

Installation Steps

1. Clone the repository:

   git clone https://github.com/yourusername/Local-Claude-Brain.git
   cd Local-Claude-Brain

2. Install dependencies:

   pip install -r requirements.txt

Usage / Run Project

Execute the orchestrator to see the multi-agent loop in action:

python orchestrator.py

What to expect:

1. You will see the Planner Agent output its step-by-step refactoring plan to the console in yellow.
2. The Executor Agent will generate the refactored text under the hood based on that exact plan.
3. A success message in green will appear, and the final polished Python script will be saved down to clean_calculator.py.

Usecase Examples

This base multi-agent foundation can be scaled for high-value B2B use cases:

1. Legacy Code Refactoring: Automatically ingest legacy monoliths piece-by-piece, plan modernization steps, and rewrite into clean microservices, prioritizing documentation and type safety.
2. Automated QA Validation: A multi-agent loop where an Executor writes code and a distinct QA Agent immediately writes and runs unit tests, passing bugs/failures back to the Executor in a self-healing loop.
3. Local Data Sanitization: Process sensitive local PII/PHI data where one agent evaluates data privacy risks and redacts sensitive entities before passing the cleaned data to downstream applications.

Future Features

1. Reviewer Agent Loop: Add a "Reviewer" agent that critiques the Executor's output and loops execution until arbitrary quality thresholds are met prior to outputting.
2. Local File-System Tool Calls: Empower agents with function calling to autonomously read, list, search, and write across an entire codebase footprint rather than just single files.
3. Vision Model Support: Integrate models like LlaVa or Qwen-VL to consume physical architectural diagrams, UI mockups, or bug screenshots, translating them directly into agentic logic schemas.