#

Sanctum: Broca 2 v0.9.1 introduces a complete installation overhaul, enabling true multi-agent consciousness support. Learn how the update transforms Broca from a single-instance system to a scalable, isolated multi-agent platform.

We're excited to announce Sanctum: Broca 2 v0.9.1, a critical infrastructure update that fundamentally changes how Broca installations work. This release addresses one of the most requested features: true multi-agent support with isolated instances for each Agent Consciousness. No more global installation conflicts—each agent now gets its own dedicated environment.

Repository: github.com/actuallyrizzn/broca-2

Highlights of This Release

🏗️ Multi-Agent Installation Architecture

Complete installation overhaul: Switched from egg-info package installation to a simple requirements.txt approach that supports multiple isolated agent instances.

Agent-specific directory structure: Each Agent Consciousness now runs in its own isolated environment under ~/sanctum/broca2// with dedicated configuration, database, and logs.

Shared virtual environment: Single venv at ~/sanctum/broca2/venv/ shared across all agents for resource efficiency.

🔧 CLI Execution Updates

Module-based CLI tools: Updated all CLI tools to use python -m cli.btool instead of global commands, eliminating installation conflicts.

Agent-specific execution: Each agent runs with python ../main.py from its own directory, maintaining complete isolation.

📚 Enhanced Documentation

New installation guide: Comprehensive INSTALL.md with step-by-step multi-agent setup instructions.

Updated README: Complete revision of folder structure and installation procedures for the new architecture.

Why This Matters

This release solves a fundamental limitation that was preventing true multi-agent deployments. Previously, installing multiple Broca instances would create global conflicts with console scripts and package metadata. Now, each Agent Consciousness can have its own isolated instance with:

• Complete isolation: Each agent has its own .env, settings.json, and sanctum.db
• No conflicts: Multiple agents can run simultaneously without interference
• Resource efficiency: Shared base installation with agent-specific data directories
• Easy management: Simple to add new agents without affecting existing ones

Technical Changes

Removed

• setup.py package configuration
• broca2.egg-info/ metadata directory
• Global console scripts (broca2 and broca-admin)

Changed

• Installation method from pip install -e . to pip install -r requirements.txt
• CLI execution from global commands to module-based execution
• Project structure to support agent-specific subdirectories

Added

• requirements.txt for simple dependency management
• INSTALL.md with comprehensive multi-agent setup guide
• Support for agent-specific directory structure

What's Next

This release sets the foundation for the planned multi-agent architecture features:

• Broca MCP Server: Centralized management and monitoring for multiple agent instances
• Advanced agent orchestration: Tools for managing agent networks and communication
• Enhanced monitoring: Per-agent metrics and health monitoring

Getting Started

For new installations:

mkdir ~/sanctum
cd ~/sanctum
git clone https://github.com/actuallyrizzn/broca-2.git broca2
cd broca2
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt

mkdir ~/sanctum cd ~/sanctum git clone https://github.com/actuallyrizzn/broca-2.git broca2 cd broca2 python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate pip install -r requirements.txt

For existing installations, simply remove the old egg-info and switch to the new requirements.txt approach.

We invite the community to test multi-agent deployments and provide feedback as we continue building toward a truly scalable agent consciousness platform.