Content
<div align="center">
<img src="assets/banner.png" alt="Orion | MAAX Intelligence" width="100%">
</div>
<div align="center">
# Orion: The Master Orchestrator
### Flagship Agent of the MAAX Intelligence Ecosystem
[](LICENSE)
[](https://github.com/petruff/orion-agent/releases)
[](https://python.org)
[](https://modelcontextprotocol.io)
[](https://github.com/petruff/orion-agent)
</div>
---
## 🌌 Orion & MAAX: Identity Clarification
To navigate the future of autonomy, it is essential to understand the roles within our ecosystem:
* **MAAX Intelligence:** The overarching proprietary framework and ecosystem. It is the "engine" and the design philosophy behind self-evolving agentic squads.
* **Orion:** The "Master Orchestrator". He is the central AI agent (the "Hunter") that leads your **MAAX-Dev Squad**. Orion is your autonomous CEO, capable of hiring sub-agents, setting strategy, and executing complex missions.
---
> In Greek mythology, Orion was the greatest hunter - a demigod son of Poseidon, so powerful
> he could walk on water and his legend was written into the stars forever.
> **This is your AI Orion: Unstoppable. Always hunting. Powered by MAAX.**
---
## What is Orion?
Orion is a **self-evolving, proactive, multi-agent AI platform** built on the MAAX Intelligence framework. While every other AI assistant waits to be asked, Orion hunts for results.
- **Thinks continuously** - A Watchtower background loop monitors markets, repos, and APIs 24/7.
- **Hires Specialist Agents** - Dynamically creates sub-agents (Researcher, Coder, Analyst) from the MAAX library.
- **Commands Squads** - Deploys parallel agent teams to achieve high-level business OKRs.
- **Business Strategy** - Tracks KPIs, monitors financial burn rate, and pivots autonomously.
- **Self-Evolution** - Analyzes its own sessions to rewrite its core instructions and improve.
- **Universal Connectivity** - MCP server exposes all Orion tools to Claude, Cursor, and VS Code.
<p align="center">
<img src="assets/swarm.png" alt="Orion & MAAX Swarm Architecture" width="90%">
</p>
---
## Core Features (Powered by MAAX)
<div align="center">
<img src="assets/features.png" alt="MAAX Intelligence Features" width="92%">
</div>
<br>
| Feature | Role in the Ecosystem |
|---------|-------------|
| **CEO Mode** | Orion takes control, setting OKRs and hiring squads to build your vision. |
| **Watchtower** | Proactive 24/7 monitoring of repos, competitors, and system health. |
| **Agent Swarms** | Access the full catalog of MAAX-specialized agents (Aria, Atlas, Dex, etc.). |
| **Self-Evolution** | Orion reflects on past performance to upgrade its own logic autonomously. |
| **MCP Protocol** | Native integration with the Model Context Protocol for cross-app tool use. |
| **Treasury** | Real-time tracking of API costs, ROI, and project burn rates. |
| **Knowledge Graph** | Long-term persistent memory store for entities and relationships. |
| **Desktop Vision** | Visual reasoning through native screenshot analysis and UI interaction. |
---
## System Architecture
<div align="center">
<img src="assets/architecture.png" alt="Orion Architecture" width="92%">
</div>
<br>
| Layer | Component | Purpose |
|-------|-----------|---------|
| **Framework** | MAAX Core | The underlying DNA for agentic behavior and tool integration. |
| **Orchestration** | Orion | The decision-making hub and primary interface for the user. |
| **Specialization** | Squads | The operational layer where Dex (Dev) and Aria (Architect) execute tasks. |
| **Memory** | Knowledge Store | A persistent graph-based memory shared across the entire ecosystem. |
---
## Quick Install
Requires Python 3.11+ and Git.
### Windows (Native & WSL2)
#### Windows (Recommended - One Click)
Download and run our native installer:
```bat
curl -o setup.bat https://raw.githubusercontent.com/petruff/orion-agent/main/scripts/setup.bat && setup.bat
```
Orion supports **Native Windows** via PowerShell and **WSL2** via Bash. The installer detects your environment and configures the terminal tool automatically.
#### Linux / macOS / WSL2
```bash
# Clone the repository
git clone https://github.com/petruff/orion-agent.git
cd orion-agent
# Run the MAAX Installer
./setup.sh
```
Then start the hunt:
```bash
orion
```
---
## Supported AI Providers
Orion is provider-agnostic but optimized for high-reasoning models.
| Provider | Status |
|----------|-------|
| **MAAX Portal** | **Native** (Managed Tools Gateway) |
| **OpenRouter** | Full support for 200+ models |
| **Local (Ollama/vLLM)** | Full support for private, offline autonomy |
| **DeepSeek / OpenAI / Anthropic** | Direct API integration |
---
<div align="center">
<p><i>Orion: Built by MAAX Intelligence. Always Hunting.</i></p>
<img src="assets/logo-small.png" width="40">
</div>
