hey-clever

Community

Always-on wake-word voice assistant.

AuthorCastrozan
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill provides an always-on wake-word based voice assistant that records spoken commands, transcribes them with Whisper, and replies via TTS.

Core Features & Use Cases

  • Activation by wake word, automatic recording, and transcription using Whisper.
  • Local processing with Silero VAD for robust voice activity detection.
  • Transcription with Whisper tiny for keyword detection and Whisper small for full command understanding.
  • Gateway communication to a Clawdbot-like backend and TTS playback of responses.
  • Optional systemd user service for auto-start and seamless background operation.

Quick Start

  • Install dependencies via the included setup script to prepare a Python venv and user service.
  • Verify input devices with: python3 hey-clever.py --list-devices
  • Start the service with: systemctl --user start hey-clever

Dependency Matrix

Required Modules

numpyonnxruntimerequestssounddeviceopenwakewordfaster_whisperedge-tts

Components

scripts

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: hey-clever
Download link: https://github.com/Castrozan/.dotfiles/archive/main.zip#hey-clever

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.