CowAgent
Open-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
- 47.5k stars
- 10.4k forks
- 35 open issues
- Language: Python
- License: MIT
- updated
Install
git clone https://github.com/zhayujie/CowAgent && cp CowAgent/*.md ~/.claude/agents/- Clone the repository and copy the agent .md definitions into ~/.claude/agents (or .claude/agents inside a project).
- Start a new Claude Code session to load the agents.
- Delegate work to them with the Task/Agent tool or by name.
Editor's note
CowAgent is an open-source Python agent framework, evolved from the widely deployed chatgpt-on-wechat project, that acts as a task-planning AI assistant running continuously on a local machine or server. It connects to Claude (alongside GPT, Gemini, DeepSeek, and others) via provider APIs, with the active model swappable from a web console at localhost:9899. The system routes incoming messages through channel integrations covering WeChat, Feishu, DingTalk, Telegram, Slack, and a built-in web interface, then passes them to an agent core that decomposes tasks, executes built-in tools (file I/O, terminal, browser automation, web search, scheduler), and calls MCP-compatible external services. A three-tier memory architecture distills conversations into context, daily, and core layers through an automatic "Deep Dream" process, while a separate knowledge module builds a Markdown wiki and evolving knowledge graph from interactions. Skills can be installed one-click from the Skill Hub or authored via natural-language conversation. Developers building multi-channel AI products and individuals wanting a self-hosted, self-evolving assistant are the primary beneficiaries.
3 items in this repository
Generate or edit images from text prompts. Use when the user asks to create, draw, design, or edit an image, illustration, photo, icon, poster, or any visual content.
Manage the personal knowledge wiki. Use when the user shares articles, documents, or asks to organize knowledge; when a conversation produces insights worth preserving as structured knowledge; or when the user asks about the knowledge base.
Create, install, or update skills in the workspace. Use when (1) installing a skill from a URL or remote source, (2) creating a new skill from scratch, (3) updating or restructuring existing skills. Always use this skill for any skill installation or creation task.
Subagents overview
[English] | [中文] | [繁體中文] | [日本語]
CowAgent is an open-source super AI assistant that proactively plans tasks, controls your computer and external services, creates and runs Skills, builds a personal knowledge base and long-term memory, forms multi-agent teams, and grows alongside you through self-evolution — a reference implementation of Agent Harness engineering.
CowAgent is lightweight, easy to deploy, and built to extend. Plug in any major LLM provider and run it 24/7 on a personal computer or server, across the web and all major IM platforms.
🌐 Website · 📖 Docs · 🚀 Quick Start · 🧩 Skill Hub · 💻 Download · ☁️ Try Online
🎬 Demo
Your browser can't play this video. Watch the demo on our website →
🌟 Highlights
| Capability | Description |
|---|---|
| Planning | Decomposes complex tasks and executes them step by step, looping over tools until the goal is reached |
| Multi-Agent | Build a team of Agents, each with its own role, model, skills, and knowledge, collaborating within a shared conversation |
| Memory | Three-tier architecture (context → daily → core), automatic Deep Dream distillation, hybrid keyword + vector retrieval |
| Knowledge | Auto-curates structured knowledge into a Markdown wiki, builds an evolving knowledge graph with visual browsing |
| Evolution | Self-Evolution reviews conversations automatically to improve skills, follow up on unfinished tasks, and consolidate memory and knowledge, growing through everyday use |
| Skills | One-click install from Skill Hub, GitHub, ClawHub; or create custom skills via natural-language conversation |
| Tools | Built-in file I/O, terminal, browser, scheduler, memory retrieval, web search, and 10+ more tools — with native MCP integration |
| Channels | Integrates with Web, WeChat, Feishu, DingTalk, WeCom, QQ, Official Accounts, Telegram, and Slack |
| Multimodal | First-class support for text, images, voice, and files — recognition, generation, and delivery |
| Models | Claude, GPT, Gemini, DeepSeek, Qwen, GLM, Kimi, MiniMax, Doubao, and more — swap providers from the Web console with one click |
| Deploy | One-line installer, unified Web console, multiple deployment modes (local, Docker, server) |
🏗️ Architecture
CowAgent is a complete Agent Harness: messages flow in through Channels; the Agent Core plans and reasons over memory, knowledge, and the available tools and skills; Models generate the response, which is sent back through the originating channel. Every layer is decoupled and independently extensible.
Read more in Architecture.
🚀 Quick Start
A one-line installer takes care of dependencies, configuration, and startup:
Linux / macOS:
bash <(curl -fsSL https://cdn.link-ai.tech/code/cow/run.sh)Windows (PowerShell):
irm https://cdn.link-ai.tech/code/cow/run.ps1 | iexDocker:
curl -O https://cdn.link-ai.tech/code/cow/docker-compose.yml
docker compose up -dOnce started, open http://localhost:9899 to access the Web console — your one-stop hub to chat with the Agent, configure models, connect channels, and install skills.
Deploying on a server? Set
web_hostto0.0.0.0inconfig.jsonto make the console reachable from outside, and setweb_passwordto protect it. Don't forget to open port9899in your firewall or security group.
📖 Detailed guides: Quick Start · Install from Source · Upgrade
After installation, manage the service with the cow CLI:
cow start | stop | restart # service control
cow status | logs # status and logs
cow update # pull latest code and restart
cow skill install <name> # install a skill
cow install-browser # install browser automation💻 Desktop client: download the CowAgent Desktop client (macOS / Windows) — the backend is bundled, ready to use out of the box.
👥 Multi-Agent Team
Create a team of Agents, each with its own memory, capabilities, knowledge, and workspace. Each can focus on its own domain, or collaborate within a shared conversation to tackle complex tasks together. Multi-Agent teams are available on the Web, the desktop client, and IM channel integrations.
See Agent Team for details.
🤖 Models
CowAgent supports all mainstream LLM providers. Chat, vision, image generation, ASR/TTS, and embeddings can each be routed to a different vendor. Providers are configured directly in the Web console — no manual file editing required.
| Provider | Featured Models | Chat | Vision | Image Gen | ASR | TTS | Embedding |
|---|---|---|---|---|---|---|---|
| DeepSeek | deepseek-flash (V4.1) / pro | ✅ | ✅ | ||||
| Claude | claude-opus-5-5 / fable-5.1 | ✅ | ✅ | ||||
| OpenAI | gpt-6.1-sol / gpt-6 series | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Gemini | gemini-3.8-flash | ✅ | ✅ | ✅ | |||
| MiniMax | MiniMax-M3 | ✅ | ✅ | ✅ | ✅ | ||
| GLM | glm-5.3-flash, glm-5v-turbo | ✅ | ✅ | ✅ | ✅ | ||
| Qwen | qwen3.8-flash | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Kimi | kimi-k3 | ✅ | ✅ | ||||
| Doubao | doubao-seed-2.1 series | ✅ | ✅ | ✅ | ✅ | ||
| ERNIE | ernie-5.1 | ✅ | ✅ | ||||
| MiMo | mimo-v2.6-pro / flash | ✅ | ✅ | ✅ | ✅ | ||
| LinkAI | One key for 100+ models | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Custom | Local models / third-party proxy | ✅ |
For details on each provider, see the Models overview.
💬 Channels
A single Agent instance can serve multiple channels in parallel. Most channels can be onboarded right from the Web console.
| Channel | Text | Image | File | Voice | Group |
|---|---|---|---|---|---|
| Web Console (default) | ✅ | ✅ | ✅ | ✅ | |
| Telegram | ✅ | ✅ | ✅ | ✅ | ✅ |
| Slack | ✅ | ✅ | ✅ | ✅ | |
| Discord | ✅ | ✅ | ✅ | ✅ | |
| ✅ | ✅ | ✅ | ✅ |
What people ask about CowAgent
What is zhayujie/CowAgent?
zhayujie/CowAgent is subagents for the Claude AI ecosystem. Open-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install. It has 47.5k GitHub stars and its last recorded update is dated 2026-10-23.
How do I install CowAgent?
You can install CowAgent by cloning the repository (https://github.com/zhayujie/CowAgent) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.
Is zhayujie/CowAgent safe to use?
Our security agent has analyzed zhayujie/CowAgent and assigned a Trust Score of 92/100 (tier: Verified). See the full breakdown of passed checks and flags on this page.
Who maintains zhayujie/CowAgent?
zhayujie/CowAgent is maintained by zhayujie. The last recorded GitHub activity is dated 2026-10-23, with 35 open issues.
Are there alternatives to CowAgent?
Yes. On ClaudeWave you can browse similar subagents at /categories/agents, sorted by popularity or recent activity.
Maintain this repo? Show its Trust Score in your README
The badge shows this repository's current Trust Score and verdict, and links back to this page. It follows the catalogue data: nobody can buy or edit the score it displays.
[](https://claudewave.com/en/repo/zhayujie-cowagent)<a href="https://claudewave.com/en/repo/zhayujie-cowagent"><img src="https://claudewave.com/api/badge/zhayujie-cowagent" alt="ClaudeWave Trust Score for zhayujie/CowAgent" width="320" height="64"></a>