Repolode
madebywelch

madebywelch/guaca

로컬 또는 VPS 백엔드에서 대화하고, 서로 작업을 위임하며, MCP 플러그인을 사용하는 AI 에이전트 그룹을 실행하는 macOS 데스크톱 앱입니다.

스타
54
포크
9
열린 이슈
0
마지막 커밋
4시간 전

어떤 프로젝트인가요?

Guaca는 AI 에이전트가 협업하고 코드를 작성하며 도구를 사용하는 데스크톱 작업 공간입니다. 백엔드는 사용자의 컴퓨터나 직접 관리하는 VPS에서 컨테이너로 실행되고, 데스크톱 앱은 해당 작업 공간에 접속하는 인터페이스 역할을 합니다. 서버를 항상 켜 두면 노트북을 닫은 뒤에도 에이전트가 계속 작업하며, 로컬 작업 공간은 컴퓨터가 켜져 있는 동안 실행됩니다.

에이전트는 그룹으로 구성되며 각 그룹에는 자체 에이전트, 설정, 플러그인이 있습니다. 플러그인은 에이전트를 외부 서비스에 연결하는 MCP 서버이며, 각 플러그인과 해당 도구를 사용할 수 있는 에이전트를 직접 지정할 수 있습니다. 에이전트는 사용자 및 서로 대화하고, 작업을 위임하며, 자체 메모리와 작업 노트를 유지합니다. 브라우저 및 컴퓨터 접근은 Kernel과 E2B를 통해 제공되며, 각 서비스의 API 키를 사용합니다.

현재 데스크톱 앱은 macOS를 지원하며, Node.js, pnpm, Rust, Xcode Command Line Tools를 사용해 소스에서 빌드합니다. 로컬 작업 공간에는 Docker가 필요하지만, VPS 백엔드에 원격으로 연결할 때는 필요하지 않습니다.

핵심 기능

  • 01에이전트, 설정, 플러그인을 서로 분리하는 그룹
  • 02에이전트별 도구 접근 제어를 지원하는 MCP 플러그인
  • 03서로 작업을 위임하고 영구 메모리를 유지하는 에이전트
  • 04Kernel과 E2B를 통한 브라우저 및 컴퓨터 접근
  • 05Docker를 사용해 로컬에서 또는 원격 VPS에서 백엔드 실행

활용 사례

  • 오프라인 상태에서도 VPS에서 계속 작업하는 코딩 에이전트 팀 운영
  • 대화와 도구를 공유하는 멀티 에이전트 워크플로 실험
  • MCP 플러그인을 통해 에이전트를 자체 서비스에 연결

빠른 시작

  1. 1

    Node.js, pnpm, Rust, Xcode Command Line Tools를 설치한 다음 저장소를 클론합니다

  2. 2

    체크아웃한 코드에서 데스크톱 앱을 빌드하고 설치합니다

    ./scripts/install.sh --no-pull --launch

사용 전 알아둘 점

  • 데스크톱 앱은 현재 macOS만 지원합니다.
  • 소스에서 빌드하려면 로컬 워크스페이스를 위해 Docker가 실행 중이어야 합니다.
  • 관리형 컴퓨팅 공간은 이후 릴리스에서 제공될 예정이며, 현재는 사용할 수 없습니다.

포함된 컬렉션

토픽

자주 묻는 질문

guaca은(는) 무엇인가요?
로컬 또는 VPS 백엔드에서 대화하고, 서로 작업을 위임하며, MCP 플러그인을 사용하는 AI 에이전트 그룹을 실행하는 macOS 데스크톱 앱입니다. Guaca는 AI 에이전트가 협업하고 코드를 작성하며 도구를 사용하는 데스크톱 작업 공간입니다. 백엔드는 사용자의 컴퓨터나 직접 관리하는 VPS에서 컨테이너로 실행되고, 데스크톱 앱은 해당 작업 공간에 접속하는 인터페이스 역할을 합니다. 서버를 항상 켜 두면 노트북을 닫은 뒤에도 에이전트가 계속 작업하며, 로컬 작업 공간은 컴퓨터가 켜져 있는 동안 실행됩니다.
guaca은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
guaca은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
guaca은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. guaca의 마지막 커밋은 2026년 11월 7일입니다.
guaca은(는) 어디에 사용할 수 있나요?
오프라인 상태에서도 VPS에서 계속 작업하는 코딩 에이전트 팀 운영 대화와 도구를 공유하는 멀티 에이전트 워크플로 실험 MCP 플러그인을 통해 에이전트를 자체 서비스에 연결
guaca는 어떻게 설치하나요?
Node.js, pnpm, Rust, Xcode Command Line Tools를 설치한 다음 저장소를 클론합니다 체크아웃한 코드에서 데스크톱 앱을 빌드하고 설치합니다: ./scripts/install.sh --no-pull --launch
guaca은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/madebywelch/guaca

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트