<div align="center">

QwenPaw

<a href="https://trendshift.io/repositories/25882" target="_blank"><img src="https://trendshift.io/api/badge/trendshift/repositories/25882/daily" alt="agentscope-ai%2FQwenPaw | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>

[Documentation] [中文] [日本語] [Русский]

<p align="center"> <img src="https://gw.alicdn.com/imgextra/i1/O1CN01sens5C1TuwioeGexL_!!6000000002443-55-tps-771-132.svg" alt="QwenPaw Logo" width="120"> </p> <p align="center"><b>Works for you, grows with you.</b></p> </div>

Your personal AI assistant — deploy locally or in the cloud, extend with Skills & Plugins, connect across every channel.

| | | | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Never forgets | Three-layer memory — live working context, full verbatim history, and a self-evolving personal knowledge base powered by ReMe. Conversations and resources continuously become readable, editable, searchable, and linked Markdown memory. | | Local or cloud, runs free | QwenPaw-Flash models (2B / 4B / 9B) trained for agent tasks. Built-in QwenPaw Local runtime — no API key, no cloud dependency. Also works with Ollama, LM Studio, or 14+ cloud providers. | | Security built in | Kernel-level Sandbox, Tool Guard, File Guard, Skill Scanner, and Access Policy. Dangerous commands are blocked before they run. | | Multi-agent & parallel | Spawn independent agents with their own memory and skills. Sub-agents at runtime. Agent Communication Protocol (ACP) for cross-system orchestration. | | File workspace | Unified file navigation, preview, editing, diffs, upload, and download across project and Agent files. | | Extensible | Skills for scheduling, documents, browser, news, and more. Plugin architecture with a marketplace. MCP integration for external tools. Combine them into purpose-built workflows. | | Reachable anywhere | DingTalk, Lark, WeChat, Discord, Telegram, iMessage, QQ — one instance, all channels. Console, TUI, and desktop app for direct access. | | Yours, not ours | Deploy locally — data stays on your machine. No third-party hosting, no data upload. |

<details> <summary><b>What you can do with QwenPaw</b></summary> <br>

• Automation & scheduling: Set up recurring tasks — news digests, report generation, multi-channel broadcasting — all on your schedule.
• Code & development: Read, edit, review, and test code in your projects with the unified file workspace.
• Document processing: Read, write, and convert PDF, Word, Excel, and PowerPoint files.
• Information gathering: Search the web, follow subscriptions, summarize videos, and find what you need in your personal knowledge base.
• Multi-channel ops: Push alerts, summaries, or AI-generated content to DingTalk, Lark, Discord, Telegram, and more — simultaneously or per channel.
• Custom workflows: Combine built-in capabilities, plugins, and scheduled tasks into workflows tailored to your needs.

</details>

---

News

• [2026-09-10] v2.2.1 | Creator 1.2 blueprint workbench, per-Agent model routing, and unified environment management. v2.2.1 Release Notes →

• [2026-09-03] v2.2.0 | Self-hosted multi-user QwenPaw Hub, QwenPaw Mail, native QwenPaw Data, unified model routing, Creator 1.1, a unified marketplace, and major Console, Skills, channel, and reliability improvements. v2.2.0 Release Notes →

• [2026-08-13] v2.1.0 | QwenPaw OS Shell, unified Files workspace, QwenPaw Creator, Codex/Qoder Agent integration, Browser-use, Computer-use, workspace checkpoints, and long-running conversation continuity. v2.1.0 Release Notes →

• [2026-07-24] v2.0.1 | PawApp mini-app platform, user-editable Agent Modes, Oh-My-Paw plugins, ReMe memory enhancements, desktop UX improvements, and more. v2.0.1 Release Notes →

• [2026-07-10] v2.0.0 — QwenPaw 2.0 Official Release 🎉 | An AgentScope 2.0 based ground-up rewrite delivering the Agent OS architecture, Loop Engineering, Scroll Context, ReMe v0.4 Self-evolving Personal Knowledge Base, and a bundled Terminal UI.

  | Highlight | What's new | |-----------|------------| | Agent OS — Workspace | Three pillars per agent: Resources (transparent on disk), Governance (allow/deny/ask/sandbox), Sandbox (macOS / Linux / Windows). | | Agent OS — Drivers | Protocol-neutral MCP / A2A / ACP connector layer with encrypted credentials and per-call policy gate. | | Loop Engineering | Advanced agent loop templates (Coding Mode, Mission Mode, more to come) with composable approval gates. | | Scroll Context | Every turn persisted; evicted turns indexed with on-demand recall — nothing summarized away. | | ReMe v0.4 Self-evolving Personal Knowledge Base | Continuously turns conversations and resources into readable, editable, searchable, and linked Markdown memory. | | Terminal UI (TUI) | Full-screen terminal chat — same agent, memory, and sessions as Console and channels. |

  Built on Agent OS, we will be launching out-of-box QwenPaw applications — such as QwenPaw Creator and QwenPaw Insight — stay tuned. v2.0.0 Release Notes →

All release notes →

---

Table of Contents

• News
• Quick Start
• API Key
• Local Models
• Security Features
• Documentation
• FAQ
• Roadmap
• Contributing
• Install From Source
• Why QwenPaw?
• Built By
• License

---

Quick Start

Option 1: Pip Install

If you prefer managing Python yourself (requires Python >= 3.11, < 3.14):

pip install qwenpaw
qwenpaw init --defaults
qwenpaw app

Then open the Console in your browser at http://127.0.0.1:8088/ to configure your model. To chat in DingTalk, Lark, WeChat, etc., see the Channel setup documentation.

---

Option 2: Script Install

No Python setup required, one command installs everything. The script will automatically download uv (Python package manager), create a virtual environment, and install QwenPaw with all dependencies (including Node.js and frontend assets). Note: May not work in restricted network environments or corporate firewalls.

macOS / Linux:

curl -fsSL https://qwenpaw.agentscope.io/install.sh | bash

Windows (CMD):

curl -fsSL https://qwenpaw.agentscope.io/install.bat -o install.bat && install.bat

Windows (PowerShell):

irm https://qwenpaw.agentscope.io/install.ps1 | iex

Note: The installer will automatically check the status of uv. If it is not installed, it will attempt to download and configure it automatically. If the automatic installation fails, please follow the on-screen prompts or execute python -m pip install -U uv, then rerun the installer.

⚠️ Special Notice for Windows Enterprise LTSC Users

If you are using Windows LTSC or an enterprise environment governed by strict security policies, PowerShell may run in Constrained Language Mode, potentially causing the following issue:

1. If using CMD (.bat): Script executes successfully but fails to write to Path

   The script completes file installation. Due to Constrained Language Mode, it cannot automatically update environment variables. Manually configure as follows:

   • Locate the installation directory:
     • Check if `u