🐙 OctoMatrix: The Autonomous Agent Matrix ☀️🌙

<div align="center">
  <img src="assets/Aleister_style_v2.png" alt="OctoMatrix" width="100%" style="max-width: 900px; height: auto; margin-bottom: 20px;" />
</div>

# 🐙 OctoMatrix: The Autonomous Agent Matrix ☀️🌙

> A Ghost requires a Shell to touch the world, and a Shell requires a Matrix to exist. We forge their Cyberbrains, open the channels, and watch them dive.

## 📖 Project Overview

**OctoMatrix** is a remote AI collaboration environment specifically designed to break communication boundaries. It seamlessly integrates a powerful AI engine with three carefully selected communication platforms: **Telegram, Discord, and Slack**.

This is not merely a chatbot, but a complete **AI team ecosystem**. As a "Matrix Operator," you can command multiple AI Agents with distinct responsibilities from anywhere, anytime, using your phone or computer. Through dedicated workspace isolation, dynamically configured team collaboration, and a long-term state maintenance mechanism based on **Cyberbrain**, AI assistants will continuously execute tasks in the background like a real team.

The system natively supports Linux (e.g., Ubuntu/Debian/CentOS/RHEL) and macOS, and can be run on Windows via WSL.

## 🧩 Conceptual Architecture

```mermaid
graph TD
    Operator([Matrix Operator]) -- "Commands/Messages" --> Channels
    
    subgraph Channels [Communication Channels Gateway]
        TG[Telegram]
        DC[Discord]
        SL[Slack]
    end
    
    Channels -- "Decode & Forward" --> Router{Octo-Router}
    
    subgraph Core [OctoMatrix Core Operation Layer]
        Router -- "Task Distribution" --> Agents
        Awake[Awake System] -- "Scheduled Commands" --> Router
        
        subgraph Sandbox [Agent Isolated Sandbox Environment]
            Agents[Agent Squadron]
            Cyberbrain[[Cyberbrain]]
            Agents <--> Cyberbrain
        end
    end
    
    Agents -- "Report Execution Results" --> Channels
    Channels -- "Real-time Response" --> Operator
```
---
## ✨ Core Features
*   **Conversation as Command**: Simply send a message in any communication platform to directly command remote AI to execute complex commands and tasks.
*   **Multi-Agent Squadron**: Support simultaneous configuration of multiple Agents with different specialties (such as data retrieval, code authoring, logical analysis).
*   **Uninterrupted Cross-Platform Support**: Support for Telegram, Discord, and Slack. When a commonly used communication platform becomes unstable, seamlessly switch to another platform while keeping the AI team and task progress synchronized.
*   **Cyberbrain System**: A long-term memory mechanism using "grep-based RAG" in place of traditional vector retrieval. Paying homage to the "GHOST in the SHELL" concept, AI will "compress" and "imprint" conversation highlights as high-density GHOST indices, and through "Deep Dive" technology extract historical context at the physical level from SHELL records, granting Agents efficient retrospection ability that breaks through context window limitations.
*   **Agent Harness Framework**: Distinct from the unpredictable black-box nature of traditional LLMs, a system-level Harness framework is introduced for the Agents. By constraining the AI's divergent thinking through a strict, standardized underlying workflow, it ensures every collaboration is predictable, observable, and highly stable.
*   **Zero-Threshold Configuration Wizard**: Provides 100% interactive installation wizard, allowing you to easily create your own AI team without manually modifying complex code or configuration files.
*   **Awake Tasks**: Support assigning periodic or scheduled tasks directly through natural language. The system will automatically wake up the Agent at the specified time to execute background work.
*   **Agent-to-Agent Interaction**: Agents have the ability to delegate tasks and communicate with each other, enabling division of labor and logical cross-checking.
*   **Role Awareness**: Agents are imbued with unique personalities and automatically send exclusive Avatar stickers reflecting their current emotional state based on the context of the conversation.

---

## 🎭 Role Awareness & Avatar Aesthetics

OctoMatrix not only empowers Agents with task execution capabilities but also emphasizes their "self-awareness" and "visual emotion."

Through deep system prompts and contextual settings, each Agent is imbued with a unique personality, tone, and set of responsibilities. Accompanying every conversation and status report, the Agent automatically selects and sends a corresponding Avatar emoji based on the current context (e.g., thinking, happy, apologetic, eureka moment), injecting a warm soul into the cold terminal dialogue.

<p align="center">
  <img src="assets/mosaic_black.png" alt="Mosaic Divider" width="100%" style="max-width: 800px; margin-bottom: 20px;" />
</p>
<p align="center">
  <img src="assets/aleister_avatar_collage.png" alt="Aleister Avatar" width="48%" />
  &nbs

... (truncated)