explaingit

nikhilachale/gwen

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 4/5LicenseSetup · moderate

TLDR

A voice-first desktop AI assistant for macOS that listens, thinks with Claude, speaks with ElevenLabs, and can control your calendar, apps, and system settings.

Mindmap

mindmap
  root((Gwen))
    What it does
      Voice AI assistant
      macOS control
      Calendar and email
    Tech stack
      TypeScript
      Electron
      Claude
      ElevenLabs
    Use cases
      Hands free system control
      Voice controlled productivity
    Audience
      Mac power users
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Talk to a voice assistant that reads your calendar and unread Gmail out loud

USE CASE 2

Control macOS system settings like volume, Wi-Fi, and dark mode by voice

USE CASE 3

Set timers, alarms, and reminders using natural spoken language

USE CASE 4

Trigger macOS Shortcuts, apps, or messages hands-free through voice commands

What is it built with?

TypeScriptElectronReactViteThree.jsSQLite

How does it compare?

nikhilachale/gwen0xradioac7iv/tempfsabboskhonov/hermium
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity4/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs Anthropic, OpenAI, and ElevenLabs API keys plus system dependencies like sox before it runs, though calendar and screen features work without extra setup.

You can use, modify, and distribute this freely, including for commercial purposes, as long as you keep the copyright notice.

In plain English

Gwen is a voice activated AI desktop assistant that runs as a local Electron application on macOS. You speak to it, it transcribes what you said, sends your request to an AI model that figures out what to do, and then speaks the answer back through a synthesized voice, all without opening a browser or typing anything. Under the hood, three services handle the interaction: OpenAI's Whisper converts your voice to text, Claude, made by Anthropic, acts as the brain that understands your request and decides which actions to take, and ElevenLabs converts the text response back into natural sounding speech. The app also shows a visual orb built with Three.js that changes color depending on Gwen's state: listening, thinking, speaking, or idle. The range of things Gwen can do is wide. On the productivity side it can read your macOS Calendar, check unread Gmail, manage local tasks and notes, and set timers or alarms using natural language. For system control it can adjust volume and brightness, toggle Wi-Fi and Bluetooth, switch dark mode, lock or sleep the machine, and send iMessages or WhatsApp messages, always confirming before it sends a message. It can also search the web, describe what is currently on your screen, open apps and files by name, place FaceTime or phone calls through a paired iPhone, get directions, and control music playback. A shortcuts bridge lets it trigger any macOS Shortcut by name, which extends it to HomeKit and other automations without writing new code. Gwen remembers preferences and facts about you in a local SQLite database between sessions. The project is built in TypeScript with Electron, using Vite and React for the interface and Three.js for the orb animation. To set it up, you install system dependencies like sox, install npm packages, fill in API keys for Anthropic, OpenAI, and ElevenLabs in an env file, and optionally connect Gmail through OAuth. It is licensed under MIT.

Copy-paste prompts

Prompt 1
Walk me through setting up Gwen with API keys for Anthropic, OpenAI Whisper, and ElevenLabs.
Prompt 2
Explain how the wake word and audio-reactive orb work together in Gwen's architecture.
Prompt 3
Show me how to add a new tool to Gwen's Claude tool-use loop.
Prompt 4
Help me connect Gmail to Gwen using the OAuth setup script.

Frequently asked questions

What is gwen?

A voice-first desktop AI assistant for macOS that listens, thinks with Claude, speaks with ElevenLabs, and can control your calendar, apps, and system settings.

What language is gwen written in?

Mainly TypeScript. The stack also includes TypeScript, Electron, React.

What license does gwen use?

You can use, modify, and distribute this freely, including for commercial purposes, as long as you keep the copyright notice.

How hard is gwen to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is gwen for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.