illusion-agent

IllusionAgent

*Where fantasy meets functionality. The best of many worlds, refined into one intelligent agent.*

中文版 | English 📖 Introduction

IllusionAgent is an open-source AI agent platform. It unifies a multi-provider LLM gateway, a bilingual (Chinese/English) CLI, a browser-based Web UI, and a flexible extension ecosystem into a single intelligent agent — at home on Windows, macOS, and Linux.

Whether you prefer the discipline of the terminal or the ease of the browser, IllusionAgent resonates with your workflow: a rich built-in toolset, specialized sub-agents, two compaction methods, MCP server support, hooks, plugins, and a cron scheduler for unattended automation — spanning Feishu, WeChat, and QQ. Standing on the shoulders of giants — Claude Code prompts, OpenHarness architecture, OpenClaw scheduling, kimi-cli infrastructure, hermes-agent channels, cc-switch routing. Core Features 🤖 Multi AI Provider Support - Anthropic, OpenAI, Copilot, Codex, and any compatible endpoint 🧠 Multi-Agent Collaboration - Built-in specialized agents (general-purpose, explore, verification) 🛠️ Rich Toolset - Full base + channel toolset + MCP dynamic tool extension 📦 Context Compaction - Microcompact (clear old tool results) + full compaction (LLM summary), auto-triggered as context fills 🌐 Web UI Interface - Browser-based chat interface with illusion web, independently usable alongside the terminal 🌍 Bilingual Interface - Chinese/English auto-switch via ui_language setting 📝 Comprehensive Markdown Rendering - Tables, code blocks, rich text 🔌 Flexible Extension System - Plugins, hoo

Welcome screen & rich text rendering

Demo video 📺 Watch demo on YouTube 🚀 Quick Start Requirements Python >= 3.10 Supports Windows, macOS, Linux Node.js 18+ (only for source install; pip install illusion-agent does not require Node.js) Installation

Desktop Edition

Prefer a desktop app without installing Python or Node.js? Download the installer for your platform — it bundles everything, zero environment setup: 👉 Download from GitHub Release

The desktop edition bundles Python 3.12 and Node.js 24 runtimes internally. See Desktop Edition docs for details. Basic Usage

Print Mode Notes

-p / --print runs a single non-interactive request and exits: