speaknow-gui 0.2.0

Realtime AI Voice Interface using OpenAI Realtime API

SpeakNow

SpeakNow is a high-performance, real-time AI voice interface built that runs on either OpenAI Realtime API, Google Gemini Flash Native Audio Live API or Grok Voice. It provides a seamless, low-latency speech-to-speech conversational experience directly in your terminal.

This project is based on and inspired by the push_to_talk_app.py example from the openai-python repository but with lots of features added.

Features

• Low-Latency Speech-to-Speech: Direct multimodal interaction using the gpt-realtime or gpt-realtime-mini or gemini-2.5-flash-native-audio models for near-instant responses.
• Real-time Transcription: View live streaming transcripts of your conversation as you speak.
• Advanced Audio Handling: Save input speech to local WAV files for record-keeping or debugging.
• Configurable Parameters: Easily adjust system prompts, model names, mode, and transcription options through a built-in TUI settings menu.
• Professional TUI: A clean, "sticky" interface with persistent headers, footers, and scrollable settings panes using textual.
• Voice Amplitude Monitor: Monitor the volume of the voice input

Installation

SpeakNow requires Python 3.11 or greater.

To install the latest version from PyPI, run:

pip install speaknow-gui

On Windows ffmpeg is required:

winget install --id=Gyan.FFmpeg

For linux, portaudio19-dev and ffmpeg are required. For example, to install on Ubuntu:

sudo apt install portaudio19-dev ffmpeg

Usage

Configuration

Before running, ensure your OPENAI_API_KEY is set in your environment variables.

In Windows open the Edit Environmnent Variables GUI and add it there.

In Linux:

export OPENAI_API_KEY="your-api-key-here"

SpeakNow provides two main entry points for different use cases. If the script don't work, make sure the scripts path for Python is included in PATH Environment Variable.

1. Standard Application

Launch the main TUI application to start a real-time session:

Windows:

speaknow.exe

Linux:

speaknow

2. Web Service Mode

Run a server-side version optimized for shared or remote environments:

Windows:

speaknow-serve.exe

Linux:

speaknow-serve

Modes:

The mode can be changed in configuration. Manual mode is triggered by hitting "Start," speaking and then hitting "Stop." to send the audio. Server VAD and uses periods of silence to automatically chunk the audio. Semantic VAD uses a semantic classifier to detect when the user has finished speaking, based on the words they have uttered.

Application Data

Logs, token usage and config file (can also be modifed in the TUI) will be stored here:

• Windows: %APPDATA%\Speaknow
• Windows when python is installed from Microsoft Store path will be something like: %LOCALAPPDATA%\Packages\PythonSoftwareFoundation.Python.3.1<....>\LocalCache\Roaming\Speaknow
• Linux: $HOME/.config/Speanow