A high-performance, private AI engine engineered for total cognitive autonomy.
The definitive synthesis of ZeroClaw execution, Hermes reasoning, and OpenClaw versatility.
Unlike generic LLM wrappers or linear agents that wait passively for prompts, Mexius operates as a persistent, localized entity. It does not just execute commands; it manages an internal ecosystem. By replacing traditional Python-heavy orchestrators with a bare-metal Rust core, Mexius achieves true sovereignty—living, learning, self-optimizing, and bifurcating its own cognition entirely on your local hardware.
Mexius is built on a "Golden-Ratio" architecture prioritizing sub-millisecond execution over bloated abstractions.
- ⚡ ZERO-LATENCY FOUNDATION: Ultra-lean Rust primitives (ZeroClaw) handle core routing, replacing heavy Python overhead to ensure sub-10ms execution and memory retrieval.
- 💾 RAM-PINNED MEMORY: Traditional disk-based vector databases bottleneck AI. Mexius pins its embedding models and LanceDB vector clusters directly to system RAM, enabling near-instant, sub-millisecond "Working Memory" recall.
- 🧠 INTELLIGENCE & AGENCY: Deep chain-of-thought reasoning (Hermes) combined with modular, unconstrained local tool-use (OpenClaw) allows the entity to interact natively with your OS.
The Mexius interface is built on a "Sharp-Professional" aesthetic (JetBrains Mono, high-contrast dark mode, gold/cyan accents). It is a high-performance mission control, not a standard chat box.
- 🔐 The Vault Gateway: A mandatory, hardware-local 4-digit PIN system protects the WebUI. Your entity remains totally inaccessible to others on the local network.
- 📊 Automotive-Grade Telemetry: Real-time hardware monitoring. CPU, GPU, and VRAM usage are displayed as highly responsive, horizontal "Power Meters" directly in the UI, keeping you aware of the entity's metabolic load.
- 🧠 Real-Time Soul Monitor: Live visualization of the agent's internal state, active context window, and emotional vectoring.
- ⚙️ Dynamic Model Mesh: A seamless settings interface to integrate and assign custom names to local or API-based models, bringing them instantly into the Mexius ecosystem.
👥 The Nexus: Multi-Agent Swarm Interface
Transition instantly from a single entity to a collaborative swarm. Within the Nexus WebUI, a visual "Bento Grid" displays your active sub-agents. A primary "Supervisor" model autonomously delegates tasks to specialized nodes (e.g., Mexius-Coder, Mexius-Strategist), allowing you to watch them peer-review, debate, and execute complex pipelines in real-time.
🌌 The Dream State: Autonomous Self-Evolution
When toggled into the "Dream State," Mexius stops processing external requests and enters a maintenance cycle. Accompanied by a pulsing golden UI overlay, the engine autonomously defragments its vector memory, synthesizes the last 24 hours of episodic logs, and rewrites its own SOUL.md to permanently crystallize new skills and align with your ongoing objectives.
1. One-Line Installation: Deploy the Mexius core on any Linux/WSL system:
curl -sSL [https://raw.githubusercontent.com/Mexor-dev/Mexius/main/install.sh](https://raw.githubusercontent.com/Mexor-dev/Mexius/main/install.sh) | bash![Uploading logo.png…]()
2. Onboard & Identity:Initialize your workspace and define the core soul:
Bash: mexius onboard
(Edit workspace/SOUL.md to refine the agent's fundamental directives).
3. Launch the Entity:Start the core engine and the secure WebUI Vault:
Bash: mexius start
4. Diagnostics:Verify system health, RAM-Pinned LanceDB access, and toolset connectivity:
Bash: mexius doctor