llama-voice 0.1.0

On-device voice processing pipeline for fast, private voice interaction

llama-voice

Llama Voice (llama-voice) is a toolkit for integrating voice interaction capabilities within the LlamaSearch AI ecosystem. It provides functionalities for processing voice input, potentially including speech-to-text (STT) and text-to-speech (TTS) using various models.

Key Features

• Voice Processing: Core components for handling voice data (processor/).
• Model Support: Designed to work with different voice models (models/), allowing flexibility in STT/TTS engines.
• Core Orchestration: A central module (core.py) likely manages the voice processing flow.
• Utilities: Includes helper functions for voice-related tasks (utils/).
• Configurable: Allows customization through configuration files (config.py).

Installation

pip install llama-voice
# Or install directly from GitHub for the latest version:
# pip install git+https://github.com/llamasearchai/llama-voice.git

Usage

(Usage examples demonstrating voice input processing, STT, or TTS will be added here.)

# Placeholder for Python client usage
# from llama_voice import VoiceClient, VoiceConfig

# config = VoiceConfig.load("path/to/config.yaml")
# client = VoiceClient(config)

# # Example: Speech-to-Text
# text_result = client.transcribe(audio_file="path/to/audio.wav")
# print(f"Transcription: {text_result}")

# # Example: Text-to-Speech
# audio_output = client.synthesize("Hello from Llama Voice!")
# with open("output.wav", "wb") as f:
#     f.write(audio_output)

Architecture Overview

graph TD
    A[Audio Input / Text Input] --> B{Core Orchestrator (core.py)};
    B -- STT Request --> C{Voice Processor (processor/)};
    C -- Uses Model --> D[STT Model (models/)];
    C --> E[Text Output];

    B -- TTS Request --> F{Voice Processor (processor/)};
    F -- Uses Model --> G[TTS Model (models/)];
    F --> H[Audio Output];

    I[Configuration (config.py)] -- Configures --> B;
    I -- Configures --> C;
    I -- Configures --> F;
    J[Utilities (utils/)] -- Used by --> C;
    J -- Used by --> F;

    style B fill:#f9f,stroke:#333,stroke-width:2px

1. Input: Receives either audio for transcription or text for synthesis.
2. Core Orchestrator: Manages the request and directs it to the processor.
3. Voice Processor: Handles the specific STT or TTS task, interacting with the selected model.
4. Models: Contains implementations or interfaces for different STT/TTS engines.
5. Output: Produces either transcribed text or synthesized audio.
6. Config/Utils: Configuration (config.py) controls behavior; Utilities (utils/) provide support functions.

Configuration

(Details on configuring STT/TTS models, language settings, audio formats, etc., will be added here.)

Development

Setup

# Clone the repository
git clone https://github.com/llamasearchai/llama-voice.git
cd llama-voice

# Install in editable mode with development dependencies
pip install -e ".[dev]"

Testing

pytest tests/

Contributing

Contributions are welcome! Please refer to CONTRIBUTING.md and submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.