What is ARIS?

ARIS connects every AI model you use — Claude, GPT, Gemini, Grok, Ollama — and makes them work as one unified system. Instead of manually switching between tools, ARIS automatically picks the best model for each task.

What you get:

• 🧠 70 pre-built skills — code review, market research, security scanning, and more
• 🔀 Smart routing — each task goes to the optimal AI model automatically
• 🛡️ Privacy-first — sensitive data stays on your machine (routes to local models)
• 💾 Persistent memory — remembers across sessions and models
• 📊 10 AI agents working as one organism
• 🔧 30 MCP tools — live backend, not static prompts
• 🎯 Impact Predictor — maps domino chain before any change
• ✅ 5-layer Verifier — contracts, sandbox, consensus, properties, audit
• 🔍 Deep Scan — kernel-level hardware intelligence (L0-L4)
• ⚡ Reactors — event-driven self-healing micro-agents

Install (pick one)

Method 1: Claude Code (easiest)

If you already have Claude Code installed:

claude mcp add --scope user aris -- npx -y aris-init --serve

Done. Restart Claude Code.

Method 2: Smithery (works with any MCP client)

npx -y @smithery/cli install aris --client claude

Works with: Claude Code, Cursor, Windsurf, VS Code.

Method 3: One-command installer

npx aris-init

Guided setup — detects your system, installs everything.

Method 4: Docker (zero dependencies)

docker run -i --rm ghcr.io/ama2alvarez-1990/aris-mcp

Nothing to install except Docker itself.

Method 5: Manual

git clone https://github.com/ama2alvarez-1990/aris.git
cd aris/src/mcp-server
pip install -e .
aris-mcp

Prerequisites (for Methods 3 and 5)

You need two things installed on your computer:

| Requirement | How to check | How to install | |-------------|-------------|----------------| | Node.js 18+ | node --version | See below | | Python 3.11+ | python3 --version | See below |

Option A: Using Homebrew (recommended)

# Install Homebrew if you don't have it
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Node.js and Python
brew install node [email protected]

Option B: Direct download

• Node.js: https://nodejs.org → Download the LTS version → Run the installer
• Python: https://www.python.org/downloads → Download 3.12+ → Run the installer

Option A: Using winget (Windows 11)

winget install OpenJS.NodeJS.LTS
winget install Python.Python.3.12

Option B: Direct download

• Node.js: https://nodejs.org → Download the LTS version → Run the .msi installer
• Python: https://www.python.org/downloads → Download 3.12+ → Check "Add to PATH" during install

Important: After installing, close and reopen your terminal (Command Prompt or PowerShell).

Ubuntu/Debian:

sudo apt update
sudo apt install -y nodejs npm python3 python3-pip python3-venv

Fedora/RHEL:

sudo dnf install -y nodejs python3 python3-pip

Arch:

sudo pacman -S nodejs npm python python-pip

If your distro ships Node.js < 18, use NodeSource:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

Install ARIS

Once Node.js and Python are ready, run one command:

npx aris-init

That's it. The installer will:

1. ✅ Check your system (Node, Python, disk space)
2. ✅ Create the ARIS directory (~/.aris)
3. ✅ Set up the MCP server (Python virtual environment)
4. ✅ Connect to your AI coding tool (Claude Code, Cursor, etc.)
5. ✅ Give you 70 free skills immediately

After Install

Restart your AI coding tool (Claude Code, Cursor, etc.), then just talk to it:

You: "review this code for security issues"
ARIS: Uses the code-reviewer skill with security focus

You: "research the competitor landscape for my SaaS"
ARIS: Uses the market-research skill with Porter's Five Forces

You: "create a diagram of my system architecture"
ARIS: Uses the excalidraw-diagrams skill

Upgrade to Pro

Free gives you 70 skills. Pro unlocks everything:

You: "aris activate <your-license-key>"

Get your key at aris4u.dev/pricing.

| | Free | Pro $9.99/mo | |---|---|---| | Skills | 70 | 70 | | Smart routing | — | ✅ | | AI memory | Basic | Full | | Cluster | 1 machine | Unlimited | | Guardian, Forge, Reactors | — | ✅ | | Security + Compliance | — | ✅ | | Predictor + Verifier | — | ✅ |

CLI Commands

npx aris-init              # Install ARIS
npx aris-init --check      # Health check — verify everything works
npx aris-init --force      # Reinstall (keeps your license)
npx aris-init --uninstall  # Remove ARIS cleanly
npx aris-init --version    # Show version
npx aris-init --help       # Show help

Works With

ARIS installs as an MCP server — it works with any AI coding tool that supports the Model Context Protocol:

• Claude Code (Anthropic) — full support
• Cursor — full support
• Windsurf — full support
• Codex CLI (OpenAI) — MCP support
• Gemini CLI (Google) — MCP support
• Any MCP-compatible tool

How It Works

┌─────────────────────────────────────────┐
│           Your AI Coding Tool           │
│    (Claude Code, Cursor, Codex, etc.)   │
└──────────────────┬──────────────────────┘
                   │ MCP Protocol
                   ▼
┌─────────────────────────────────────────┐
│              ARIS MCP Server            │
│  ┌─────────┐ ┌────────┐ ┌───────────┐  │
│  │ Router  │ │ Memory │ │ Guardian  │  │
│  │ 15 cats │ │ 5-layer│ │ HW health │  │
│  └─────────┘ └────────┘ └───────────┘  │
│  ┌─────────┐ ┌────────┐ ┌───────────┐  │
│  │  Forge  │ │ Budget │ │  Scout    │  │
│  │ creator │ │ costs  │ │ discovery │  │
│  └─────────┘ └────────┘ └───────────┘  │
│  ┌─────────┐ ┌────────┐ ┌───────────┐  │
│  │Predictor│ │Verifier│ │ Deep Scan │  │
│  │ impact  │ │5-layer │ │ kernel L0 │  │
│  └─────────┘ └────────┘ └───────────┘  │
│  ┌──────────────────────────────────┐   │
│  │     70 Skills • 16 Agents       │   │
│  └──────────────────────────────────┘   │
└─────────────────────────────────────────┘

Troubleshooting

npx comes with Node.js. Install Node.js first (see prerequisites above).

ARIS needs Python 3.11+. Check with python3 --version.

On Windows, try python --version (without the 3). If Python is installed but not found, you may need to add it to your PATH — reinstall Python and check "Add to PATH".

Don't use sudo. If you get permission errors, fix npm permissions:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

1. Restart your AI coding tool completely (not just reload)
2. Run npx aris-init --check to verify the MCP server is configured
3. Check that your tool's MCP config includes the ARIS server entry

Links

• 🌐 Website: aris4u.dev
• 📦 GitHub: github.com/ama2alvarez-1990/aris
• 💬 Support: GitHub Issues