📌 CoPaw란 무엇인가요?
CoPaw(Co Personal Agent Workstation)는 AgentScope 팀에서 제작한 오픈 소스, 자체 호스팅 개인 AI 어시스턴트입니다. 설치 및 배포가 간편하도록 설계되었으며, 개인 컴퓨터 또는 클라우드에 설치하여 일상적으로 사용하는 채팅 앱과 원활하게 연동할 수 있습니다.
"CoPaw"라는 이름은 Co Personal Agent Workstation의 약자이며, "co-paw" 즉, 항상 곁에 있는 따뜻한 파트너를 연상시키는 언어유희입니다. 차가운 생산성 도구를 넘어, CoPaw는 여러분의 디지털 생활을 위한 유용한 동반자가 되도록 만들어졌습니다.
🚀 주요 기능
1. 멀티 채널 지원
CoPaw는 단일 에이전트를 통해 주요 메시징 및 협업 플랫폼에 연결됩니다.
- DingTalk
- Feishu
- Discord
- iMessage
- 확장 가능한 채널 통합을 통한 추가 기능
2. 유연한 배포
| 방법 | 설명 |
|---|---|
pip install copaw |
표준 Python 설치, 3단계 명령으로 빠른 시작 |
| 한 줄 설치기 | Python 불필요 — 설치 프로그램이 모든 것을 자동으로 처리 |
| Docker | 단일 명령으로 풀링 및 실행 |
| ModelScope Studio | 로컬 설치 없이 원클릭 클라우드 설정 |
3. 로컬 모델 지원
API 키나 클라우드 서비스 없이 LLM을 자체 하드웨어에서 완전히 실행할 수 있습니다.
| 백엔드 | 최적 |
|---|---|
| llama.cpp | 크로스 플랫폼 (macOS / Linux / Windows) |
| MLX | Apple Silicon Mac (M1/M2/M3/M4) |
copaw models download Qwen/Qwen3-4B-GGUF
copaw models # 다운로드한 모델 선택
copaw app # 서버 시작
4. 확장 가능한 스킬 시스템
- 자동화된 작업을 위한 내장 cron 작업 스케줄러
- 작업 공간에 저장되고 시작 시 자동 로드되는 사용자 정의 스킬
- 벤더 종속성 없음 — 여러분의 스킬, 여러분의 데이터
5. 메모리 및 개인화
- 제어 가능한 컨텍스트 관리 및 장기 기억
- 연결된 모든 채널로 전달되는 예약 알림
- 연구 및 메모 작성을 위한 개인 지식 기반
6. 웹 콘솔 UI
http://127.0.0.1:8088/에서 제공되는 깔끔한 브라우저 기반 콘솔에서 다음을 수행할 수 있습니다.
- 어시스턴트와 직접 채팅
- 모델 및 API 키 구성
- 채널 관리
- 환경 변수 설정
🛠️ 빠른 시작
# 설치
pip install copaw
# 기본값으로 초기화
copaw init --defaults
# 콘솔 실행
copaw app
그런 다음 브라우저에서 http://127.0.0.1:8088/ 을 엽니다.
💡 사용 사례
| 카테고리 | 예시 |
|---|---|
| 소셜 | 샤오홍슈, 즈후, 레딧의 인기 게시물 일일 요약; 빌리빌리/유튜브 동영상 요약 |
| 생산성 | DingTalk/Feishu/QQ로 푸시되는 뉴스레터 요약; 이메일 및 캘린더에서 연락처 관리 |
| 창의적 | 하룻밤 사이에 목표를 설명하고 아침까지 초안 준비 |
| 연구 | AI/기술 뉴스 추적; 개인 지식 기반 구축 |
| 데스크톱 | 로컬 파일 정리; 문서 읽기 및 요약; 채팅을 통한 파일 요청 |
| 자동화 | 스킬 + cron을 결합하여 자체 에이전트 워크플로우 구축 |
🏗️ 아키텍처 개요
CoPaw
├── src/copaw/ # 핵심 Python 패키지
│ ├── agent/ # 에이전트 로직 및 메모리
│ ├── skills/ # 내장 및 사용자 스킬
│ └── channels/ # 메시징 플랫폼 통합
├── console/ # TypeScript/React 웹 콘솔 프론트엔드
├── deploy/ # Docker 및 클라우드 배포 구성
├── scripts/ # 설치 스크립트 (bash, PowerShell)
└── website/ # 문서 사이트
기술 스택:
- 백엔드: Python 3.10–3.14, AgentScope 기반
- 프론트엔드: TypeScript + React
- 로컬 추론: llama.cpp, MLX
- 라이선스: Apache 2.0
📦 설치 옵션
pip (권장)
pip install copaw
한 줄 (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/agentscope-ai/CoPaw/master/scripts/install.sh | bash
한 줄 (Windows PowerShell)
irm https://raw.githubusercontent.com/agentscope-ai/CoPaw/master/scripts/install.ps1 | iex
Docker
docker pull agentscope/copaw:latest
docker run -p 8088:8088 -v copaw-data:/app/working agentscope/copaw:latest
📖 문서
전체 문서: https://copaw.agentscope.io/
| 주제 | 링크 |
|---|---|
| 소개 | docs/intro |
| 빠른 시작 | docs/quickstart |
| 콘솔 | docs/console |
| 채널 | docs/channels |
| 스킬 | docs/skills |
| 로컬 모델 | docs/local-models |
| 메모리 | docs/memory |
| CLI | docs/cli |
🤝 커뮤니티 및 링크
- GitHub: https://github.com/agentscope-ai/CoPaw
- Discord: 서버 참여
- 제작: AgentScope 팀
- 별: 101 | 포크: 13 | 최신 릴리스: v0.0.3 (2026년 2월 27일)
⚖️ 라이선스
CoPaw는 Apache License 2.0에 따라 출시되었습니다. 사용, 수정 및 배포가 무료입니다.