Tether

Tether is a Python library for thought capture and audio transcription.

Structure

• core/ — Configuration, LLM client, and shared utilities
• engine/ — Full CLI engine with audio recording, speech-to-text, and AI integration
• jobs/ — Background job processing for daily summaries
• app/ — Desktop UI wrapper (PyQt/pystray)

Usage

The library can be used in several ways:

As a module (engine)

python -m engine

With the desktop UI

python main.py

Installation

pip install -e .

Development

Install in development mode:

pip install -e ".[dev]"

Run tests:

pytest