euvictorldev/hades-agent

★ 25TypeScriptAudience · generalComplexity · 3/5ActiveLicenseSetup · easy

Mindmap

mindmap
  root((Hades Agent))
    Inputs
      Keyboard shortcuts
      PC audio stream
      Typed questions
    Outputs
      Live transcripts
      Grounded answers
      Session cost HUD
    Use Cases
      Hidden assistant during calls
      Live meeting transcription
      Web-grounded Q and A
    Tech Stack
      Electron
      React
      Gemini Live
      Tavily

mindmap root((Hades Agent)) Inputs Keyboard shortcuts PC audio stream Typed questions Outputs Live transcripts Grounded answers Session cost HUD Use Cases Hidden assistant during calls Live meeting transcription Web-grounded Q and A Tech Stack Electron React Gemini Live Tavily

Things people build with this

USE CASE 1

Run a Gemini-powered assistant on Windows that does not show up in OBS, Zoom, Teams, or Discord screen shares.

USE CASE 2

Transcribe PC audio in real time while watching a lecture or call, using Alt+B to toggle the overlay.

USE CASE 3

Ask grounded questions through Alt+D and get answers backed by Tavily web search instead of model memory.

USE CASE 4

Track per-session token use and running cost in a small heads-up display, and reset between tasks.

Tech stack

ElectronReactTypeScriptViteGeminiTavily

Getting it running

Difficulty · easy Time to first run · 30min

Windows-only (10 tested, 11 untested) and you need two free API keys, one from Google AI Studio and one from Tavily, before anything works.

MIT license, so you can use, modify, and ship it commercially as long as you keep the copyright notice.

In plain English

Hades Agent is a desktop application for Windows that sits quietly in the system tray and pops up when you press one of a few keyboard shortcuts. The README describes it as an AI companion built with Electron, React, and Google's Gemini Live API. It has two main jobs: answering questions with real-time web search, and transcribing audio coming out of your PC speakers as it happens. The author keeps it deliberately limited: the program is sandboxed with zero file-write access, so it cannot create, change, or delete files on your computer, and the only outside services it talks to are Google's Gemini API for the model itself and the Tavily Search API for grounding web results. A central feature, and one the README spends a lot of space on, is its invisibility to screen capture. Hades uses a Windows-specific Electron call called setContentProtection so that its windows do not appear in OBS Studio, Discord, Teams, Zoom, or other Windows screen-capture tools. This is also the reason the project does not support macOS or Linux. The README is explicit that it has only been tested on Windows 10, with Windows 11 untested. The interaction model is keyboard-driven. Alt+D opens a floating command bar where you type a question and get an answer grounded in live web search. Alt+B opens a transcription overlay that streams PC audio at 16 kHz to the Gemini Live API and prints the transcript back with very low latency. Alt+S opens settings (where you also paste your two free API keys, one from Google AI Studio and one from Tavily), Alt+V toggles voice input, and Esc hides the active window. Every shortcut can be rebound. There is also a small persistent chat heads-up display that shows the current model, token count, and running session cost, with a one-click reset. Two extra pieces round it out. A 'Dream Memory Consolidation' job runs in the background and compresses recent session logs into a smaller file called learnings.json, which the README compares to how the brain consolidates memory during sleep. And a 'Safe Task Scheduler' lets you queue automated web searches and reminders, stored in a local sandboxed ledger rather than written out as scripts or system files. To use the released installer you download the .exe from the Releases page; to build from source you need Node.js 18 or newer, then npm install and npm run dev, which starts Vite and Electron together with hot reload. The license is MIT.

Copy-paste prompts

Prompt 1

Download the latest Hades Agent release on Windows 11, paste my Google AI Studio and Tavily keys into Alt+S, and verify Alt+D returns a grounded answer.

Prompt 2

Build Hades Agent from source on Windows with Node 20. Show the exact npm scripts and what Vite plus Electron hot reload looks like.

Prompt 3

Rebind the global shortcuts so Alt+D becomes Ctrl+Space and Alt+B becomes Ctrl+Shift+T, and persist the change across restarts.

Prompt 4

Explain how setContentProtection hides Electron windows from screen capture on Windows and why this does not port to macOS or Linux.

Prompt 5

Describe the Dream Memory Consolidation job: when it runs, what it writes to learnings.json, and how to inspect or reset it.

Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.