gitwtfhub

wtf is assistant-ai?

aleksandern/assistant-ai — explained in plain English

Analysis updated 2026-05-18

3PythonAudience · developerComplexity · 4/5Setup · moderate

TL;DR

A desktop AI assistant that listens to apps like Zoom or Telegram, transcribes speech locally, and answers using an attached document or screenshots.

Mindmap

mindmap
  root((repo))
    What it does
      Listens to app audio
      Transcribes speech
      Analyzes screenshots
    Tech stack
      Python
      whisper.cpp
      OpenAI
    Use cases
      Live call assistance
      Document grounded answers
    Audience
      Developers
      AI tinkerers

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

Why would anyone build with this?

REASON 1

Get real time AI generated talking points during a Zoom or Teams call

REASON 2

Analyze a screenshot for context aware AI feedback

REASON 3

Feed a document into the assistant so its answers stay grounded in it

What's in the stack?

Pythonwhisper.cppSilero VADScreenCaptureKitOpenAI

How it stacks up

aleksandern/assistant-ai0marildo/imago0xdfi/glm-5.2-1m-4x-dgx-spark
Stars333
LanguagePythonPythonPython
Setup difficultymoderateeasyhard
Complexity4/52/55/5
Audiencedevelopergeneralresearcher

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

How do you spin it up?

Difficulty · moderate Time to first run · 1h+

Requires an OpenAI API key and macOS specific audio capture via ScreenCaptureKit.

Wtf does this do

AssistantAI is a desktop application that listens in on a selected app, such as Zoom, Teams, Telegram, or a browser, and picks up on spoken conversation happening there in real time. It can then generate context aware responses based on a document the user has attached, and it can also analyze screenshots through a built in web interface. The author describes it as a personal engineering project meant to explore low latency desktop AI, speech processing, and screenshot analysis, rather than a finished commercial product. A short demo video linked in the README shows the assistant reacting to a live conversation as it happens. Under the hood it captures audio from a specific application using Apple's ScreenCaptureKit, so it appears to be built primarily for macOS. It uses Silero VAD to detect when someone is actually speaking, and then runs the audio through whisper.cpp locally to turn speech into text. From there it can bring in an attached document to shape its responses to the conversation, keep a local history of past conversations, and expose a remote web interface so the assistant can be reached from elsewhere, rather than only being usable on the same machine it runs on. The project is currently written in Python. The README points to a setup script for the Python environment and a separate Python README for fuller installation instructions and OpenAI configuration details, meaning it currently relies on OpenAI's models for at least part of its response generation rather than running a local language model. The roadmap lists plans to support additional local model backends like Ollama and llama.cpp, handle more document formats, and improve the screenshot analysis feature, suggesting the current version is an early, actively evolving build rather than a finished release.

Yoink these prompts

Prompt 1
Walk me through setting up the Python environment for this project using setup_python_env.sh.
Prompt 2
Explain how ScreenCaptureKit and Silero VAD work together to detect speech from a specific app.
Prompt 3
Help me configure OpenAI API access for this assistant as described in python/README.md.
Prompt 4
Show me how whisper.cpp is used here to transcribe audio locally instead of sending it to a cloud service.

Frequently asked questions

wtf is assistant-ai?

A desktop AI assistant that listens to apps like Zoom or Telegram, transcribes speech locally, and answers using an attached document or screenshots.

What language is assistant-ai written in?

Mainly Python. The stack also includes Python, whisper.cpp, Silero VAD.

How hard is assistant-ai to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is assistant-ai for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.