Repolode
sonichi

sonichi/sutando

Mac에서 로컬로 실행되며 음성, 화면, 통화, 메시지로 사용자를 대신해 작업하는 macOS 중심 개인용 AI 에이전트입니다.

스타
399
포크
97
열린 이슈
1,415
마지막 커밋
8시간 전

어떤 프로젝트인가요?

Sutando는 사용자의 Mac에서 실행되는 셀프 호스팅 개인용 AI 에이전트입니다. 핵심 에이전트로 Claude Code 또는 Codex CLI를 사용하고, 브라우저 대화를 위한 Gemini Live 음성 인터페이스와 Twilio 기반 전화 통화 기능을 제공합니다. 화면 내용을 설명하거나 보고 있는 텍스트를 편집하고, 캘린더를 확인하고, Zoom 또는 Google Meet 통화에 참여해 메모를 작성하고, 이메일을 보내거나 검색하도록 요청할 수 있습니다.

작업은 실시간 음성 처리와 백그라운드 코어가 나눠서 처리합니다. 화면 캡처나 통화 종료 같은 빠른 작업은 인라인으로 실행하고, 더 큰 요청은 tasks 폴더에 기록해 코어 CLI가 실행한 뒤 요청이 들어온 채널로 결과를 전달합니다. Telegram, Discord, Slack 브리지도 같은 작업 처리 경로를 사용하며, 예약 루프가 상태를 점검하고 유휴 상태일 때 자율 작업을 수행합니다. 환경 변수를 설정해 자율적인 자기 개발 기능을 끌 수 있습니다.

이 프로젝트는 알파 단계입니다. 핵심 기능은 Node.js 22 이상과 Python 3이 설치된 macOS 15 이상에서 실행되며, Windows 포트는 음성, 화면 캡처, 메시징 브리지 등 헤드리스 기능을 지원합니다. 전화 통화와 회의 전화 접속에는 Twilio와 ngrok이 필요합니다. 에이전트는 로컬 시스템에 광범위한 권한을 사용하므로 설정 과정에서 소유자와 인증된 발신자에 대한 접근 제한을 구성해야 합니다.

핵심 기능

  • 01Gemini Live를 통한 브라우저 음성 대화와 Twilio를 통한 전화 통화를 지원합니다.
  • 02화면을 캡처하고 내용을 설명하므로 디스플레이에 표시된 내용에 관해 질문할 수 있습니다.
  • 03캘린더 일정을 바탕으로 Zoom 및 Google Meet 통화에 참여하고 참가자 정보를 기록합니다.
  • 04Telegram, Discord, Slack, 로컬 에이전트 API에서 작업을 받아 동일한 코어로 처리합니다.
  • 05발신자별 접근 권한 단계와 함께 상태 점검 및 자율 작업을 위한 예약 루프를 실행합니다.

활용 사례

  • 계속 작업하면서 음성으로 화면의 텍스트를 편집하거나 요약할 수 있습니다.
  • 예정된 회의에 참여시키고 통화가 끝난 뒤 요약을 받을 수 있습니다.
  • 다른 일에 집중하는 동안 대신 전화를 걸거나 메시지를 남기게 할 수 있습니다.
  • Telegram이나 Discord를 통해 휴대폰에서 Mac으로 작업을 보낼 수 있습니다.

빠른 시작

  1. 1

    저장소를 클론합니다

    git clone https://github.com/sonichi/sutando.git
  2. 2

    프로젝트 디렉터리로 이동합니다

    cd sutando
  3. 3

    macOS 또는 Linux에서 모든 구성 요소(core, app, dashboard)를 시작합니다

    ./start.sh

사용 전 알아둘 점

  • 알파 단계: 아직 초기 단계인 프로젝트로, 기능을 계속 다듬고 있습니다.
  • macOS 우선으로 설계되었습니다. Windows에서 시작하려면 별도의 스크립트를 사용해야 합니다.
  • Claude Code 또는 Codex CLI를 설치하고 로그인해야 합니다.
  • 권한을 높이고 승인 절차 없이 실행되므로 로컬 환경에 완전히 접근할 수 있습니다.

토픽

자주 묻는 질문

sutando은(는) 무엇인가요?
Mac에서 로컬로 실행되며 음성, 화면, 통화, 메시지로 사용자를 대신해 작업하는 macOS 중심 개인용 AI 에이전트입니다. Sutando는 사용자의 Mac에서 실행되는 셀프 호스팅 개인용 AI 에이전트입니다. 핵심 에이전트로 Claude Code 또는 Codex CLI를 사용하고, 브라우저 대화를 위한 Gemini Live 음성 인터페이스와 Twilio 기반 전화 통화 기능을 제공합니다. 화면 내용을 설명하거나 보고 있는 텍스트를 편집하고, 캘린더를 확인하고, Zoom 또는 Google Meet 통화에 참여해 메모를 작성하고, 이메일을 보내거나 검색하도록 요청할 수 있습니다.
sutando은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
sutando은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
sutando은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. sutando의 마지막 커밋은 2026년 10월 22일입니다.
sutando은(는) 어디에 사용할 수 있나요?
계속 작업하면서 음성으로 화면의 텍스트를 편집하거나 요약할 수 있습니다. 예정된 회의에 참여시키고 통화가 끝난 뒤 요약을 받을 수 있습니다. 다른 일에 집중하는 동안 대신 전화를 걸거나 메시지를 남기게 할 수 있습니다. Telegram이나 Discord를 통해 휴대폰에서 Mac으로 작업을 보낼 수 있습니다.
sutando는 어떻게 설치하나요?
저장소를 클론합니다: git clone https://github.com/sonichi/sutando.git 프로젝트 디렉터리로 이동합니다: cd sutando macOS 또는 Linux에서 모든 구성 요소(core, app, dashboard)를 시작합니다: ./start.sh
sutando은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/sonichi/sutando

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

관련 프로젝트