evo-nexus

Disclaimer: EvoNexus is an independent, unofficial open-source project. It is not affiliated with, endorsed by, or sponsored by Anthropic. "Claude" and "Claude Code" are trademarks of Anthropic, PBC. This project integrates with Claude Code as a third-party tool and requires users to provide their own installation and credentials.

What It Is

EvoNexus is an open source, unofficial multi-agent operating layer built around the Claude Code CLI protocol — but not locked to any single LLM provider. It runs natively on Anthropic's claude CLI by default, and can transparently switch to OpenAI, Google Gemini, OpenRouter (200+ models), AWS Bedrock, Google Vertex AI, or Codex Auth via OpenClaude. Same agents, same skills, same workflows — your choice of backend.

It turns a single CLI installation into a team of 38 specialized agents organized in two ortogonal layers — 17 business agents (operations, finance, community, marketing, HR, legal, product, data, learning retention) and 21 engineering agents (architecture, planning, code review, testing, debugging, security, design, cycle orchestration, retrospective — 19 derived from oh-my-claudecode, MIT, by Yeachan Heo + 2 native: Helm and Mirror). The engineering layer follows a canonical 6-phase workflow documented in .claude/rules/dev-phases.md.

This is not a chatbot. It is a real operating layer that runs routines, generates HTML reports, syncs meetings, triages emails, monitors community health, tracks financial metrics, and consolidates everything into a unified dashboard — all automated.

Part of the Evolution Foundation ecosystem

EvoNexus is one of the projects maintained by Evolution Foundation. It is the operating layer that orchestrates the Foundation's own work — including the development of Evo CRM Community, Evolution API and Evolution Go.

Why EvoNexus?

• Markdown-first agents — agents are .md files with system prompts, not code. No SDK, no compile step. Add an agent by dropping a file in .claude/agents/, or package reusable bundles via the plugin system (see docs/introduction.md)
• Skills as instructions — reusable capabilities are markdown too. 190+ skills covering finance, community, social, engineering, data, legal, HR, ops, product, CS
• Multi-provider by design — default runs on Anthropic's native claude CLI, but can switch to OpenRouter, OpenAI, Gemini, AWS Bedrock, Google Vertex, or Codex Auth via OpenClaude without touching a line of code. Your keys, your model choice, no vendor lock-in
• MCP integrations — first-class support for Google Calendar, Gmail, GitHub, Linear, Telegram, Canva, Notion, and more via the Model Context Protocol
• Slash commands — /clawdia, /flux, /pulse, /apex invoke agents directly from the terminal
• Persistent memory — CLAUDE.md + per-agent memory survives across sessions
• CLI-first, local-only — runs anywhere the Claude CLI (or OpenClaude) runs. Your data never leaves your infrastructure

Key Features

• Multi-Provider — runs on Anthropic (native claude) or any of 6 alternate backends via OpenClaude: OpenRouter (200+ models), OpenAI, Google Gemini, Codex Auth, AWS Bedrock, Google Vertex AI. Switch providers from the dashboard, no code changes
• 17 Core Business Agents + Custom — Ops, Finance, Projects, Community, Social, Strategy, Sales, Courses, Learning Retention, Personal, Knowledge, Marketing, HR, Customer Success, Legal, Product, Data — plus user-created custom-* agents (gitignored)
• 21 Engineering Agents — architecture, planning, code review, testing, debugging, security, design, cycle orchestration, retrospective
• 190+ Skills + Custom — organized by domain prefix (social-, fin-, int-, prod-, mkt-, gog-, obs-, discord-, pulse-, sage-, hr-, legal-, ops-, cs-, data-, pm-, dev-)
• 7 Core + 20 Custom Routines — daily, weekly, and monthly ADWs managed by a scheduler
• Web Dashboard — React + Flask app with auth, roles, web terminal, service management
• 19+ Integrations — Google Calendar, Gmail, Linear, GitHub, Discord, Telegram, Stripe, Omie, Bling, Asaas, Fathom, Todoist, YouTube, Instagram, LinkedIn, Evolution API, Evolution Go, Evo CRM, and more
• Persistent Memory — two-tier system (CLAUDE.md + memory/) with LLM Wiki pattern
• Knowledge Base — optional semantic search via MemPalace (local ChromaDB vectors, one-click install)
• Full Observability — JSONL logs, execution metrics, cost tracking per routine
• Heartbeats — proactive agents that wake on a schedule, run a 9-step protocol, and decide whether to act
• Goal Cascade — Mission → Project → Goal → Task hierarchy
• Tickets — persistent conversation/work threads with atomic checkout

Screenshots

Quick Start

Starting out? After installing, open Claude Code and call /oracle. It's the official entry point of EvoNexus: runs the initial setup, interviews you about your business, shows what the toolkit can automate for you, and delivers a phased activation plan.

Method 1 — Docker (no setup, runs anywhere)

curl -O https://raw.githubusercontent.com/evolution-foundation/evo-nexus/main/docker-compose.hub.yml
docker compose -f docker-compose.hub.yml up -d
open http://localhost:8080

The setup wizard loads on first boot. Paste your Anthropic / OpenAI / Codex key and you're done. Full guide: docs/guides/docker-install.md.

Method 2 — One command (CLI)

npx @evoapi/evo-nexus

Method 3 — Manual clone (developers / contributors)

git clone --depth 1 https://github.com/evolution-foundation/evo-nexus.git
cd evo-nexus

# Interactive setup wizard
make setup

Prerequisites

AI Providers

EvoNexus runs on Anthropic's Claude by default. For OpenAI, Gemini, Bedrock, OpenRouter, Vertex AI, or Codex Auth, it switches to OpenClaude.

npm install -g @gitlawb/openclaude

The setup wizard asks which provider you want during make setup, and you can switch at any time from the Providers page in the dashboard.

Web Dashboard

A full web UI at http://localhost:8080:

make dashboard-app   # Start Flask + React on :8080

Architecture