local-voice-gateway

Official

Run a full local ASR→LLM→TTS gateway.

AuthorTrac-Systems
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Local voice gateway for Clawfinger provides a self-contained, on-device gateway that runs the entire ASR → LLM → TTS pipeline without relying on cloud services, enabling offline development and testing.

Core Features & Use Cases

  • Local gateway (FastAPI) that exposes REST API endpoints, a control center UI, and an agent WebSocket interface for integration with the Clawfinger Android app.
  • On-device inference stack (ASR via mlx_audio Parakeet, LLM via mlx-lm or remote endpoints, TTS via Kokoro for English and Piper for German).
  • Cross-platform support (macOS and Linux) with ADB reverse port forwarding for phone connectivity.
  • Comprehensive installation, configuration, operation, and troubleshooting guidance, including security and network-local hosting constraints.

Quick Start

Create a Python virtual environment, install the required dependencies, copy the example config to config.json, and start the gateway with the provided start script.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 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: local-voice-gateway
Download link: https://github.com/Trac-Systems/clawfinger-gateway/archive/main.zip#local-voice-gateway

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.