CoPaw: Co Personal Agent Workstation

1.0.2 · active · verified Wed Apr 15

CoPaw is an open-source personal AI workstation designed to run in your local environment, emphasizing data sovereignty and extensibility. It acts as a personal assistant, communicating across multiple channels (e.g., DingTalk, Feishu, Discord) and executing scheduled tasks. Its capabilities are driven by 'Skills,' which can be extended through custom Python scripts. All data and tasks are processed on the user's machine, ensuring privacy without relying on third-party hosting. The library is actively developed with frequent updates, with version 1.0.2 being the latest stable release.

Warnings

breaking CoPaw is reportedly being rebranded to 'QwenPaw'. While the PyPI package is still `copaw` at version 1.0.2, future releases or a parallel project might use the new name, potentially leading to package name changes or diverging development paths.
Fix: Monitor official announcements from the developers for migration paths or new package names. Check the GitHub repository for updates.
gotcha Configuring API keys for cloud-based LLMs (e.g., DashScope, ModelScope) is a common source of errors. Issues often arise from missing API keys, incorrect base_url settings, or case-sensitive model names.
Fix: Ensure all API key fields are correctly filled, double-check for extra spaces, and verify that model names exactly match provider values (case-sensitive) in the Console's 'Settings -> Models' section.
gotcha Windows users employing the one-line PowerShell installation script may encounter issues due to 'Constrained Language Mode,' which can prevent the automatic download of `uv` (Python package manager).
Fix: Manually install `uv` (refer to GitHub Releases for `uv.exe` or `pip install -U uv`), then configure `uv` environment variables and add `~/.copaw/bin` to your system's PATH. Re-run the installation script afterwards.
gotcha The first launch of CoPaw can take 10-60 seconds, depending on system configuration, as it initializes the Python environment and loads dependencies. Users might mistakenly perceive the application as frozen.
Fix: Exercise patience during the initial startup. The browser window should open automatically once initialization is complete.

Install

pip install copaw Pip Installation (Recommended for Developers)
curl -fsSL https://copaw.agentscope.io/install.sh | bash One-line Installer (macOS/Linux - no Python setup required)
irm https://copaw.agentscope.io/install.ps1 | iex One-line Installer (Windows PowerShell - no Python setup required)

Quickstart

This quickstart installs CoPaw via pip, initializes the default workspace and configuration files, and then launches the web console. After running `copaw app`, open http://127.0.0.1:8088/ in your browser to interact with the assistant. [1, 2, 3, 4, 11, 12]

pip install copaw
copaw init --defaults
copaw app

view raw JSON →