proferai

Profer는 로컬 우선(local-first) 범용 AI 에이전트 데스크톱 앱으로, Claude Agent SDK와 Pi Agent 이중 런타임으로 구축되었습니다. 간단한 질문은 Chat에, 복잡한 작업은 Agent에 맡기고, 강력한 로컬 AI 에이전트 기능 위에 팀 협업 레이어를 더하는 것을 목표로 합니다. **핵심 기능** - **범용 에이전트**: `@anthropic-ai/claude-agent-sdk` 기반으로 작업 그래프 분해, 하위 작업 의존성 오케스트레이션, 스트리밍 출력, 계획 확인을 지원하며 Claude / Pi 이중 런타임 간 전환이 가능합니다. - **협업 서브 에이전트**: 복잡한 작업을 여러 실제 하위 세션에 병렬로 분할하여 독립적으로 진행하고, 완료 후 결과를 집계하며 전체 과정이 투명하게 추적 가능합니다. - **예약 작업 자동화**: 영구 스케줄링(interval / daily / weekly / monthly)을 지원하며 실행 기록, 실패 보호, 결과 리뷰 기능을 갖추어 일일/주간 보고서, 자동 점검 등 무인 시나리오에 적합합니다. - **모바일 원격 접속**: 로컬 HTTP/WS를 통해 PC에 원격 접속하며, 모바일에서 Chat, 설정 동기화, 끊김 시 재연결을 지원합니다(클라이언트는 별도 저장소 Profer-pocket, Capacitor Android 기반). - **팀 워크스페이스**: 초대제 팀(Owner / Admin / Member / Viewer 역할 권한)을 지원하며 Skills 공유 마켓, 파일 클라우드 동기화, 브랜드 커스터마이징을 제공합니다. - **다중 모델 Chat**: 다중 공급자 대화, 첨부 파일 파싱(PDF / Office / 이미지), Markdown / Mermaid / KaTeX / 코드 하이라이트, 나란히 비교, 컨텍스트 관리를 지원합니다. - **Skills & MCP**: 각 워크스페이스에서 Skills와 MCP Server를 독립적으로 구성할 수 있으며, 전체 화면 스킬 뷰에서 검색, 활성화, 업데이트, 가져오기, 제거, 팀 게시가 가능합니다. - **원격 봇**: Feishu / Lark / DingTalk / WeChat 브리지를 지원하며, 휴대폰이나 그룹 채팅을 통해 로컬 에이전트 워크플로우를 트리거할 수 있습니다. - **데스크톱 경험**: 자동 업데이트, 전역 단축키, 빠른 작업 창, 스트리밍 음성 입력(Doubao), 라이트 / 다크 / 다양한 정교한 테마를 제공합니다. **지원 모델 채널** Anthropic, DeepSeek, Kimi API, Kimi Coding Plan, OpenAI, Google, Zhipu AI, MiniMax, Doubao, Tongyi Qianwen 및 사용자 정의 엔드포인트(OpenAI 호환)를 지원합니다. Anthropic 및 Anthropic 호환 채널은 에이전트 기능을 지원하며, OpenAI, Google 및 사용자 정의 엔드포인트는 Chat만 지원합니다. **기술 스택** - 런타임: Bun - 데스크톱 프레임워크: Electron 43 - 프론트엔드: React 18 + TypeScript + Jotai - 스타일: Tailwind CSS + Radix UI - 리치 텍스트 / 차트: TipTap · Beautiful Mermaid · KaTeX · Shiki - 빌드: Vite + esbuild + electron-builder - 에이전트 SDK: `@anthropic-ai/claude-agent-sdk@0.3.201`(Claude) + `@earendil-works/pi-agent@0.82.1`(Pi) 이중 런타임 - 모바일: Capacitor(Android) - 팀 백엔드: Hono + better-sqlite3 + JWT **빠른 시작** GitHub Releases에서 최신 버전을 다운로드하면 macOS Apple Silicon / Intel 및 Windows 설치 패키지를 제공합니다. 첫 구성 시 환경 검사(Git, Node.js / Bun 및 사용 가능한 Shell 의존)를 완료한 후 설정에서 AI 채널을 추가하고 기본 채널, 모델, 워크스페이스를 선택합니다. 팀 협업 기능은 경량 백엔드 서비스(Hono + SQLite)를 배포해야 하며, 모든 Linux 서버에 원클릭 배포가 가능합니다. **로컬 개발** Bun 워크스페이스 모노레포로 packages(shared, core, project-core, session-core, ui), apps(electron, cli) 및 server 디렉터리를 포함합니다. `bun install`로 의존성을 설치하고, `bun run dev`로 개발 모드를 시작하며, `bun run typecheck`로 타입 검사를, `bun test`로 테스트를 실행합니다. **기여** PR 제출을 환영하며 프로젝트 규칙을 따라야 합니다: Bun 사용, 상태 관리는 Jotai, TypeScript에서 `any` 금지, 새 IPC 추가 시 관련 타입 및 브리지 코드 동기 수정. **라이선스** Profer는 Proma 기반으로 개발되었으며 커뮤니티 버전은 AGPL-3.0 프로토콜을 채택합니다.