pai-muvs은(는) 무엇을 하나요?
PAI(개인 AI 인프라) 포크 — 텔레그램 주제별 멀티 에이전트 오케스트레이터로, 주제별 영구 메모리, Claude Code 스킬 통합, 미니 앱 대시보드, 다국어 지원을 제공합니다. 개인 또는 기업용으로 배포 가능합니다.
기능
- 주제별 메모리: 각 텔레그램 주제(thread)가 자체적인 메모리와 컨텍스트를 가집니다.
- 멀티 에이전트 오케스트레이션: 여러 AI 에이전트를 동시에 관리하고 조정합니다.
- Claude Code 스킬 통합: Claude Code의
~/.claude/skills/디렉토리에 있는 스킬을 자동으로 인식하고 사용합니다. - 미니 앱 대시보드: 설정, 로그, 성능 모니터링을 위한 웹 대시보드를 제공합니다.
- 다국어 지원: 여러 언어로 응답을 지원합니다.
- 확장 가능한 배포: Docker 또는 수동 설치로 개인 서버부터 기업 환경까지 배포 가능합니다.
빠른 시작
# 저장소 복제
git clone https://github.com/undergnarly/pai-muvs.git
cd pai-muvs
# 환경 설정
cp .env.example .env
# .env 파일을 편집하여 텔레그램 봇 토큰 및 기타 설정 입력
# Docker로 실행 (권장)
docker-compose up -d
# 또는 수동 설치
pip install -r requirements.txt
python main.py
환경 변수
| 변수 | 설명 | 기본값 |
|---|---|---|
TELEGRAM_BOT_TOKEN | 텔레그램 봇 토큰 (필수) | - |
OPENAI_API_KEY | OpenAI API 키 | - |
ANTHROPIC_API_KEY | Anthropic API 키 | - |
DATABASE_URL | 데이터베이스 연결 문자열 | sqlite:///pai.db |
SKILLS_DIR | Claude Code 스킬 디렉토리 경로 | ~/.claude/skills/ |
LANGUAGE | 기본 언어 | en |
Claude Code 스킬 사용
PAI는 ~/.claude/skills/ 디렉토리에서 Claude Code 스킬을 자동으로 로드합니다. 각 스킬은 다음과 같은 구조를 가져야 합니다:
~/.claude/skills/
├── my-skill/
│ ├── SKILL.md
│ └── (추가 파일)
└── another-skill/
├── SKILL.md
└── (추가 파일)
명령어
/start- 봇 시작 및 환영 메시지/help- 도움말 메시지 표시/agents- 활성 에이전트 목록 보기/dashboard- 미니 앱 대시보드 URL 얻기/language [코드]- 언어 설정 변경 (예:/language ko)
배포
Docker 배포 (권장)
docker-compose -f docker-compose.prod.yml up -d
수동 배포
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
python main.py
라이선스
MIT