# linyiLYi/voice-assistant

A simple toy demo of a local voice assistant with whisper and large language model.

Repository: https://github.com/linyiLYi/voice-assistant
Canonical: https://ross.abutalabs.com/products/voice-assistant
Language: Python
License: Apache-2.0
License Family: permissive
Last push: 2024-04-30T14:11:14+00:00

## Health v2 (maintenance only)
Score: 26/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 71
- inputs: {"age_days": 998, "days_push": 855, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1323, forks 212 (observed 2026-08-28T04:04:22.138412+00:00)

## What it is
A simple single-script Python demo of a local voice assistant that uses Whisper (via Apple MLX) for speech recognition and a local Yi large language model (GGUF via llama-cpp-python) to generate spoken responses. It is a toy project tested on macOS, not a production-ready assistant.

## Use cases
- run a voice assistant fully locally on my mac
- talk to a local LLM with my microphone
- demo whisper speech recognition with a local chat model
- learn how to build a simple voice assistant in python
- offline voice chat without cloud APIs

## When to choose
- you want a minimal, readable example of wiring Whisper + a local LLM together
- you are on macOS with Apple Silicon and want MLX/Metal acceleration
- you need a learning or prototyping starting point for voice assistants

## When to avoid
- you need a production voice assistant with wake words, streaming, or multi-turn memory
- you need first-class Windows or Linux support (the readme only suggests workarounds)
- you want a polished installable application rather than a single script

## Facets
- artifact type: application
- maturity: experimental
- function: speech-recognition, llm-inference, audio-processing, chatbot
- domain: artificial-intelligence, large-language-models, speech-processing
- platform: python
- tags: voice-assistant, whisper, local-llm, mlx, yi-model, toy-demo, gguf, llama-cpp, voice-assistants, macos, desktop

## Member repositories
- linyiLYi/voice-assistant (main) score 26

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:22.138412+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:47:05.214084+00:00, confidence not recorded.
  - readme: https://github.com/linyiLYi/voice-assistant (fetched 2026-08-28T04:04:22.138412+00:00, sha 7c67527bd702)
- Data as of 2026-08-30T08:39:29.467469+00:00.