Metadata-Version: 2.4
Name: HoloTTS
Version: 0.1.8
Summary: Modern Speech Recognition with both active and ambient listening and keyboard 
Author: Tristan McBride Sr.
Author-email: "Tristan McBride Sr." <142635792+TristanMcBrideSr@users.noreply.github.com>
Maintainer-email: "Tristan McBride Sr." <142635792+TristanMcBrideSr@users.noreply.github.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/TristanMcBrideSr
Keywords: AI,Agents,Speech Recognition,Productivity,Automation
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: SpeechRecognition
Requires-Dist: requests
Dynamic: author

﻿
---

# HoloTTS

## Overview

**HoloTTS** is a modern, thread-safe text-to-speech and audio processing manager for Python applications.
It provides real-time TTS synthesis, advanced audio manipulation, pipeline automation, and flexible playback for AI, productivity, and automation workflows.

**Highlights:**

* **Text-to-speech output:** Instantly generate speech from any text input.
* **Advanced audio handling:** Manipulate, convert, and normalize audio files and streams.
* **Flexible playback:** Directly play audio, control output devices, and manage volume.
* **Pipeline integration:** Designed for seamless use with batch and real-time audio workflows.
* **Thread-safe:** Safe for use in multi-threaded and production environments.
* **Easy to extend:** Clean interface for custom audio processing and integration.

---

## Why HoloTTS?

Standard TTS or audio modules are often limited to basic playback or export, and lack robust audio processing or automation.
**HoloTTS** solves these problems by combining:

* Seamless text-to-speech and audio processing in one interface.
* Real-time playback and device control.
* Advanced transformation and automation support.

---

## Key Features

* **Flexible TTS and Audio:**
  Convert text to speech, process and playback audio on demand.

* **Audio Manipulation:**
  Edit, slice, merge, and transform audio files and streams.

* **Pipeline-Ready:**
  Integrate with systems like `kokoro` for advanced batch and real-time audio workflows.

* **Configurable Playback:**
  Control volume, speed, and output devices as needed.

* **Production-Ready:**
  Robust error handling, state tracking, and thread safety for modern applications.

---

## How It Works

1. **Instantiate HoloTTS** in your Python app.
2. **Convert text to speech** or manipulate audio as required.
3. **Playback or export** audio results.
4. **Integrate** with bots, automations, or AI pipelines.

---

## FAQ

**Q: Does HoloTTS require a specific project structure?**
A: No. Organize your code as you see fit.

**Q: Can I extend or customize audio pipelines?**
A: Yes. All processing and TTS methods are fully accessible.

**Q: Is HoloTTS thread-safe and production-ready?**
A: Yes. Designed for robust, multi-threaded use.

---

## Code Examples

You can find code examples on my [GitHub repository](https://github.com/TristanMcBrideSr/TechBook).

---

## License

This project is licensed under the [Apache License, Version 2.0](LICENSE).
Copyright 2025 Tristan McBride Sr.

---

## Acknowledgements

Project by:
- Tristan McBride Sr.
- Sybil
