Repolode
Submit
sonichi

sonichi/sutando

A macOS-first personal AI agent that runs locally on your Mac, using voice, screen, calls, and messaging to act on your behalf.

View on GitHubWebsite
Stars
399
Forks
97
Open issues
1,415
Last commit
7 hours ago

What is it?

Sutando is a self-hosted personal AI agent that runs on your own Mac. It uses Claude Code or Codex CLI as its core agent, and adds a Gemini Live voice interface for browser conversation and a Twilio-based path for phone calls. You can ask it to describe your screen, edit text you are looking at, read your calendar, join Zoom or Google Meet calls, take notes, and send or search email.

Work is split between real-time voice handling and a background core. Quick actions such as screen capture or hanging up run inline, while larger requests are written to a tasks folder, executed by the core CLI, and reported back through the channel they came from. Telegram, Discord, and Slack bridges use the same task path, and a scheduled loop runs health checks and picks up autonomous work when idle. Autonomous self-development can be turned off with an environment variable.

The project is in alpha. Its core features run on macOS 15+ with Node.js 22+ and Python 3, and a Windows port covers the headless parts such as voice, screen capture, and messaging bridges. Phone and meeting dial-in need Twilio and ngrok, and the agent runs with broad local permissions, so access gating for owner and verified callers is part of the setup.

Key features

  • 01Voice conversation in the browser via Gemini Live, plus phone calls through Twilio.
  • 02Screen capture and description, so you can ask questions about what is on your display.
  • 03Joins Zoom and Google Meet calls using calendar entries and captures participant info.
  • 04Accepts tasks from Telegram, Discord, Slack, and a local agent API, all handled by the same core.
  • 05Runs a scheduled loop for health checks and autonomous work, with access tiers for callers.

Use cases

  • Editing or summarizing text on your screen by voice while you keep working.
  • Joining scheduled meetings and getting a summary when the call ends.
  • Making a phone call or leaving a message on your behalf while you focus elsewhere.
  • Sending tasks to your Mac from your phone through Telegram or Discord.

Quick start

  1. 1

    Clone the repository

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

    Enter the project directory

    cd sutando
  3. 3

    Start everything on macOS or Linux (core, app, dashboard)

    ./start.sh

Things to know

  • Alpha stage: an early-stage project with features still being hardened.
  • Designed macOS-first; Windows startup is a separate script.
  • Requires Claude Code or Codex CLI installed and signed in.
  • Runs with elevated permissions and unattended approvals, so it has full local access.

Topics

#personal-agent#voice-assistant#ai-agent#macos#self-hosted#claude#automation#multi-agent#gemini#open-source

FAQ

What is sutando?
A macOS-first personal AI agent that runs locally on your Mac, using voice, screen, calls, and messaging to act on your behalf. Sutando is a self-hosted personal AI agent that runs on your own Mac. It uses Claude Code or Codex CLI as its core agent, and adds a Gemini Live voice interface for browser conversation and a Twilio-based path for phone calls. You can ask it to describe your screen, edit text you are looking at, read your calendar, join Zoom or Google Meet calls, take notes, and send or search email.
Is sutando free to use? What license does it have?
sutando is open source under the MIT license. Check the license terms before using it in commercial products.
Is sutando still maintained?
Actively maintained. The last commit to sutando was on Oct 22, 2026.
What can I use sutando for?
Editing or summarizing text on your screen by voice while you keep working. Joining scheduled meetings and getting a summary when the call ends. Making a phone call or leaving a message on your behalf while you focus elsewhere. Sending tasks to your Mac from your phone through Telegram or Discord.
How do I install sutando?
Clone the repository: git clone https://github.com/sonichi/sutando.git Enter the project directory: cd sutando Start everything on macOS or Linux (core, app, dashboard): ./start.sh
Where can I get sutando?
The source code and installation instructions are on GitHub: https://github.com/sonichi/sutando

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects