Skip to main content

Welcome to CitadelMesh

CitadelMesh is an autonomous multi-agent platform that makes commercial buildings intelligent, safe, and efficient.

🎯 What is CitadelMesh?​

Think of CitadelMesh as giving your building a nervous system and brain:

  • 🤖 AI Agents: Specialized agents for security, energy, and coordination
  • 🛡️ Safety-First: Every action validated by policies (no unsafe operations)
  • 🔌 Vendor-Neutral: Works with Schneider, Avigilon, EcoStruxure, and more
  • ⚡ Edge-First: Runs at the building, works offline, cloud optional
  • 📊 Observable: Full visibility into agent decisions and actions

🚀 Start Here​

Never Used CitadelMesh Before?​

🎓 Getting Started (30 minutes)

  • Learn key concepts in 5 minutes
  • See it in action with real scenarios
  • Understand how agents coordinate
  • Perfect for beginners!

Ready to Dive Deeper?​

Choose your path:

The Chronicles​

The Chronicles are our beginner-friendly epic journey through building CitadelMesh:

  • Part I: Foundation Awakens - Protocols, OPA, SPIFFE, and agent runtime
  • Part II: Agent Intelligence - Security and energy optimization agents
  • Part III: Vendor Diplomacy - Schneider, Avigilon, and EcoStruxure integration
  • Part IV: Orchestration - Multi-agent coordination and conflict resolution

Start Reading →

🎯 Core Capabilities​

Multi-Agent Coordination​

  • Security agent monitors threats and coordinates door locks + cameras
  • Energy agent optimizes HVAC using scipy-based mathematical optimization
  • Building orchestrator balances safety, comfort, and efficiency

Safety-First Architecture​

  • Every agent action validated by OPA policies
  • Fail-safe defaults: deny unless explicitly allowed
  • Complete audit trail with CloudEvents
  • Temperature bounds, access controls, rate limits enforced

Production-Ready​

  • .NET Aspire orchestration with hot reload
  • NATS event bus with CloudEvents protocol
  • PostgreSQL persistence, Redis caching
  • OpenTelemetry full-stack observability

📊 Project Status​

CitadelMesh is actively developed with multiple phases complete:

  • ✅ Foundation Complete - Protocols, OPA, SPIFFE, agent runtime
  • ✅ Vendor Integration - Schneider, Avigilon, EcoStruxure adapters
  • ✅ Agent Intelligence - Security and energy agents operational
  • ✅ Living Building Interface - 3D Digital Twin with time travel replay (Phases 2-5 complete)
  • 🔄 Production Readiness - K3s deployment and observability (85% complete)

Latest Achievement: Completed immersive 3D visualization with time travel capabilities - making autonomy visible and trustworthy.

See the Progress Dashboard for detailed status.

🤝 Contributing​

CitadelMesh is open source and welcomes contributions. See our Contributing Guide for:

  • Development environment setup
  • Code standards and testing requirements
  • How to submit pull requests
  • Community guidelines

📚 Technology Stack​

  • Agents: Python, LangGraph, LangChain
  • Services: .NET 8, Node.js/TypeScript
  • Protocols: Protobuf, gRPC, CloudEvents
  • Policy: Open Policy Agent (OPA)
  • Identity: SPIFFE/SPIRE
  • Orchestration: .NET Aspire
  • Observability: OpenTelemetry, Aspire Dashboard

🏗️ Architecture Highlights​

Protocol-First Design​

Type-safe Protobuf schemas for all events and commands with CloudEvents wrapping for standardization.

Zero-Trust Safety​

OPA policies evaluate every action. Agents cannot bypass safety constraints. Complete audit trail for compliance.

Edge Autonomy​

Built for edge deployment with K3s. Operates autonomously when cloud is unavailable. Real-time processing at the building edge.

Vendor Agnostic​

MCP adapter pattern integrates any vendor system. Currently supports Schneider, Avigilon, EcoStruxure, with Home Assistant in progress.

Ready to explore? Start with The Chronicles or jump into Getting Started.