CowAgent

<p align="center"><img src="https://github.com/user-attachments/assets/eca9a9ec-8534-4615-9e0f-96c5ac1d10a3" alt="CowAgent" width="420" /></p> <p align="center"> <a href="https://github.com/zhayujie/CowAgent/releases/latest"><img src="https://img.shields.io/github/v/release/zhayujie/CowAgent?cacheSeconds=3600" alt="Latest release"></a> <a href="https://github.com/zhayujie/CowAgent/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License: MIT"></a> <a href="https://github.com/zhayujie/CowAgent"><img src="https://img.shields.io/github/stars/zhayujie/CowAgent?style=flat-square&cacheSeconds=3600" alt="Stars"></a> <a href="https://docs.cowagent.ai/"><img src="https://img.shields.io/badge/Docs-cowagent.ai-blue?style=flat&logo=readthedocs&logoColor=white" alt="Docs"></a> <a href="https://cdn.link-ai.tech/code/cow/cowagent-wechat-group.png"><img src="https://img.shields.io/badge/WeChat-Group-07C160?style=flat&logo=wechat&logoColor=white" alt="WeChat Group"></a> <a href="https://discord.gg/9U8eA8v9TR"><img src="https://img.shields.io/badge/Discord-Join-5865F2?style=flat&logo=discord&logoColor=white" alt="Discord"></a> </p> <p align="center"> <a href="https://trendshift.io/repositories/25763" target="_blank"><img src="https://trendshift.io/api/badge/repositories/25763" alt="zhayujie%2FCowAgent | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a> </p> <p align="center"> [English] | [<a href="docs/zh/README.md">中文</a>] | [<a href="docs/zh/README-Hant.md">繁體中文</a>] | [<a href="docs/ja/README.md">日本語</a>] </p>

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, 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.

<p align="center"> <a href="https://cowagent.ai/">🌐 Website</a> &nbsp;·&nbsp; <a href="https://docs.cowagent.ai/intro/index">📖 Docs</a> &nbsp;·&nbsp; <a href="https://docs.cowagent.ai/guide/quick-start">🚀 Quick Start</a> &nbsp;·&nbsp; <a href="https://skills.cowagent.ai/">🧩 Skill Hub</a> &nbsp;·&nbsp; <a href="https://cowagent.ai/download/">💻 Download</a> &nbsp;·&nbsp; <a href="https://link-ai.tech/cowagent/create">☁️ Try Online</a> </p> <br/>

🎬 Demo

<p align="center"> <video src="https://github.com/user-attachments/assets/8625a19f-615c-4343-8be8-3707ce4d4d4e" controls muted playsinline width="720"> Your browser can't play this video. <a href="https://cowagent.ai/">Watch the demo on our website →</a> </video> </p> <br/>

🌟 Highlights

| Capability | Description | | :--- | :--- | | Planning | Decomposes complex tasks and executes them step by step, looping over tools until the goal is reached | | 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) |

<br/>

🏗️ Architecture

<img src="https://cdn.jsdelivr.net/gh/zhayujie/cowagent-assets@main/architecture/en/architecture.png" alt="CowAgent Architecture" width="750"/>

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.

<br/>

🚀 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 | iex

Docker:

curl -O https://cdn.link-ai.tech/code/cow/docker-compose.yml
docker compose up -d

Once 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_host to 0.0.0.0 in config.json to make the console reachable from outside, and set web_password to protect it. Don't forget to open port 9899 in 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.

<br/>

🤖 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 | | --- | --- | :-: | :-: | :-: | :-: | :-: | :-: | | Claude | claude-opus-5 / sonnet-5 | ✅ | ✅ | | | | | | OpenAI | gpt-5.6 series | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | Gemini | gemini-3.5-flash | ✅ | ✅ | ✅ | | | | | DeepSeek | deepseek-v4-flash / pro | ✅ | | | | | | | Qwen | qwen3.7-plus | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | GLM | glm-5.2, glm-5v-turbo | ✅ | ✅ | | ✅ | | ✅ | | Doubao | doubao-seed-2.1 series | ✅ | ✅ | ✅ | | | ✅ | | Kimi | kimi-k3 | ✅ | ✅ | | | | | | MiniMax | MiniMax-M3 | ✅ | ✅ | ✅ | | ✅ | | | ERNIE | ernie-5.1 | ✅ | ✅ | | | | | | MiMo | mimo-v2.5 / pro | ✅ | ✅ | | | ✅ | | | LinkAI | One key for 100+ models | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | Custom | Local models / third-party proxy | ✅ | | | | | |

For details on each provider, see the Models overview.

<br/>

💬 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 | ✅ | ✅ | ✅ | | ✅ | | WeChat | ✅ | ✅ | ✅ | ✅ | | | Feishu / Lark | ✅ | ✅ | ✅ | ✅ | ✅ | | DingTalk | ✅ | ✅ | ✅ | ✅ | ✅ | | WeCom Bot | ✅ | ✅ | ✅ | ✅ | ✅ | | QQ | ✅ | ✅ | ✅ | | ✅ | | WeCom App | ✅ | ✅ | ✅ | ✅ | | | WeChat Customer Service | ✅ | ✅ | ✅ | ✅ | | | WeChat Official Account | ✅ | ✅ | | ✅ | |

See the Channels overview for setup details.

<img src="https://cdn.jsdelivr.net/gh/zhayujie/cowagent-assets@main/screenshots/en/web-console-chat.png" alt="CowAgent Web Console" width="800"/>

The Web console is the default channel and the unified entry point to configure models, channels, skills, memory, and more.

<br/>

🧠 Memory & Knowledge Base

Long-term memory uses a three-tier architecture: conversation context (short-term) → daily memory (mid-term) → MEMORY.md (long-term). A nightly Deep Dream pass distills scattered memories into refined long-term entries and a narrative journal. See Long-term Memory · Deep Dream.

Personal knowledge base complements the time-ordered memory by organizing structured knowledge by topic. The Agent automatically curates valuable information from conversations, maintains cross-references and indexes, and the Web console offers an interactive knowledge-graph view. See Personal Knowledge Base.

<table> <tr> <td width="50%"> <img src="https://cdn.jsdelivr.net/gh/zhayujie/cowagent-assets@main/screenshots/en/web-console-memory.png" alt="Long-term Memory" /> <p align="center"><em>Long-term Memory · Three-tier architecture + Deep Dream</em></p> </td> <td width="50%"> <img src="https://cdn.jsdelivr.net/gh/zhayujie/cowagent-assets@main/screenshots/en/web-console-knowledge.png" alt="Personal Knowledge Base" /> <p align="center"><em>Knowledge Base · Auto-curated Markdown wiki</em></p> </td> </tr> </table> <br/>

🔧 Tools & Skills

Tools are atomic capabilities the Agent uses to interact with system resources. Skills are higher-level workflows defined by a manifest file that compose multiple tools to accomplish complex tasks.

Tool System

Built-in tools cover file I/O (read / write / edit / ls), terminal (bash), file sending (send), memory retrieval (memory), environment variables (env_config), web fetching (web_fetch), scheduling (scheduler), web search (web_search), vision (vision), and browser automation (browser).

MCP protocol integrates the open ecosystem of [Model Context Protocol]