---
# HoloEcho
## Overview
**HoloEcho** is a thread-safe, modular orchestrator for voice, sound, and keyboard-driven interaction in Python applications.
It unifies text-to-speech, speech recognition, audio signaling, and multi-modal input/output management—making it ideal for next-generation AI assistants, agent frameworks, and productivity tools.
**Highlights:**
* **Modular design:** Seamlessly integrates HoloTTS (text-to-speech), HoloSTT (speech input), and HoloWave (sound playback).
* **Multi-modal input/output:** Switch instantly between voice, keyboard, and ambient interaction.
* **Custom command mapping:** Flexible phrase recognition and user-definable command sets.
* **Thread-safe singleton:** Robust for multi-threaded, event-driven, and long-running applications.
* **Production-ready:** Centralized error handling, channel management, and extensible APIs.
---
## Why HoloEcho?
Voice-first and multi-modal applications demand more than simple speech-to-text or TTS.
**HoloEcho** brings together advanced voice recognition, TTS, audio feedback, and stateful input management—enabling:
* Natural switching between voice and keyboard modes.
* Real-time audio cues and contextual feedback.
* Easy addition of new commands and phrase triggers.
* Seamless orchestration of all sound and voice resources.
---
## Key Features
* **Unified Input Management:**
Handle active/ambient voice, keyboard input, and quick mode switches from a single class.
* **Custom Command Mapping:**
Map any phrase to custom actions or mode changes—user commands are merged with defaults for maximum flexibility.
* **Integrated Audio Feedback:**
Play sound cues and synthesize voice output using HoloTTS and HoloWave.
* **Stateful Operation:**
Tracks activation, standby, pause, and mode status for robust agent-like interaction.
* **Thread-Safe Singleton:**
Safe for concurrent access and automation workflows.
---
## How It Works
1. **Instantiate HoloEcho** in your application.
2. **Configure commands and phrases** as needed (or use the built-in defaults).
3. **Handle input and output** via integrated methods (`voiceInput`, `ambientInput`, `keyboardInput`, `synthesize`, `getSound`).
4. **Switch modes** and manage agent state using built-in command recognition.
---
## FAQ
**Q: Do I need to manage TTS, speech recognition, and sound playback separately?**
A: No. HoloEcho wraps and orchestrates HoloTTS, HoloSTT, and HoloWave for you.
**Q: Can I add or override commands and phrases?**
A: Yes. Pass your own command dictionary or phrases; HoloEcho will merge them with defaults.
**Q: Is HoloEcho thread-safe and suitable for production?**
A: Yes. The singleton and locking mechanisms make it robust for advanced apps.
---
## 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.
---
## Authors
- Tristan McBride Sr.
- Sybil
Raw data
{
"_id": null,
"home_page": null,
"name": "HoloEcho",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "\"Tristan McBride Sr.\" <142635792+TristanMcBrideSr@users.noreply.github.com>",
"keywords": "AI, Agents, Speech Recognition, Text to Speech, Productivity, Automation",
"author": "Tristan McBride Sr.",
"author_email": "\"Tristan McBride Sr.\" <142635792+TristanMcBrideSr@users.noreply.github.com>",
"download_url": "https://files.pythonhosted.org/packages/9a/2a/e9ead1f763deace4f78e08fa627d973bbdb3253a1ca9740b654c1f488828/holoecho-0.2.1.tar.gz",
"platform": null,
"description": "\ufeff\r\n---\r\n\r\n# HoloEcho\r\n\r\n## Overview\r\n\r\n**HoloEcho** is a thread-safe, modular orchestrator for voice, sound, and keyboard-driven interaction in Python applications.\r\nIt unifies text-to-speech, speech recognition, audio signaling, and multi-modal input/output management\u2014making it ideal for next-generation AI assistants, agent frameworks, and productivity tools.\r\n\r\n**Highlights:**\r\n\r\n* **Modular design:** Seamlessly integrates HoloTTS (text-to-speech), HoloSTT (speech input), and HoloWave (sound playback).\r\n* **Multi-modal input/output:** Switch instantly between voice, keyboard, and ambient interaction.\r\n* **Custom command mapping:** Flexible phrase recognition and user-definable command sets.\r\n* **Thread-safe singleton:** Robust for multi-threaded, event-driven, and long-running applications.\r\n* **Production-ready:** Centralized error handling, channel management, and extensible APIs.\r\n\r\n---\r\n\r\n## Why HoloEcho?\r\n\r\nVoice-first and multi-modal applications demand more than simple speech-to-text or TTS.\r\n**HoloEcho** brings together advanced voice recognition, TTS, audio feedback, and stateful input management\u2014enabling:\r\n\r\n* Natural switching between voice and keyboard modes.\r\n* Real-time audio cues and contextual feedback.\r\n* Easy addition of new commands and phrase triggers.\r\n* Seamless orchestration of all sound and voice resources.\r\n\r\n---\r\n\r\n## Key Features\r\n\r\n* **Unified Input Management:**\r\n Handle active/ambient voice, keyboard input, and quick mode switches from a single class.\r\n\r\n* **Custom Command Mapping:**\r\n Map any phrase to custom actions or mode changes\u2014user commands are merged with defaults for maximum flexibility.\r\n\r\n* **Integrated Audio Feedback:**\r\n Play sound cues and synthesize voice output using HoloTTS and HoloWave.\r\n\r\n* **Stateful Operation:**\r\n Tracks activation, standby, pause, and mode status for robust agent-like interaction.\r\n\r\n* **Thread-Safe Singleton:**\r\n Safe for concurrent access and automation workflows.\r\n\r\n---\r\n\r\n## How It Works\r\n\r\n1. **Instantiate HoloEcho** in your application.\r\n2. **Configure commands and phrases** as needed (or use the built-in defaults).\r\n3. **Handle input and output** via integrated methods (`voiceInput`, `ambientInput`, `keyboardInput`, `synthesize`, `getSound`).\r\n4. **Switch modes** and manage agent state using built-in command recognition.\r\n\r\n---\r\n\r\n## FAQ\r\n\r\n**Q: Do I need to manage TTS, speech recognition, and sound playback separately?**\r\nA: No. HoloEcho wraps and orchestrates HoloTTS, HoloSTT, and HoloWave for you.\r\n\r\n**Q: Can I add or override commands and phrases?**\r\nA: Yes. Pass your own command dictionary or phrases; HoloEcho will merge them with defaults.\r\n\r\n**Q: Is HoloEcho thread-safe and suitable for production?**\r\nA: Yes. The singleton and locking mechanisms make it robust for advanced apps.\r\n\r\n---\r\n\r\n## Code Examples\r\n\r\nYou can find code examples on my [GitHub repository](https://github.com/TristanMcBrideSr/TechBook).\r\n\r\n---\r\n\r\n## License\r\n\r\nThis project is licensed under the [Apache License, Version 2.0](LICENSE).\r\nCopyright 2025 Tristan McBride Sr.\r\n\r\n---\r\n\r\n## Authors\r\n- Tristan McBride Sr.\r\n- Sybil\r\n",
"bugtrack_url": null,
"license": null,
"summary": "Modern STT AND TTS for modern AI-projects",
"version": "0.2.1",
"project_urls": {
"Homepage": "https://github.com/TristanMcBrideSr"
},
"split_keywords": [
"ai",
" agents",
" speech recognition",
" text to speech",
" productivity",
" automation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c7c3af8cb5d9a70bf84e618d2bda13df851077cbce8686dc6f9b57016d537acc",
"md5": "38ed2e990a7950377236ed2603a161ea",
"sha256": "61c0a1d26d33e52058a52783099f34fbd72870e037c8e7f671cf0dd15a6c9730"
},
"downloads": -1,
"filename": "holoecho-0.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "38ed2e990a7950377236ed2603a161ea",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 8174,
"upload_time": "2025-08-30T03:18:01",
"upload_time_iso_8601": "2025-08-30T03:18:01.965076Z",
"url": "https://files.pythonhosted.org/packages/c7/c3/af8cb5d9a70bf84e618d2bda13df851077cbce8686dc6f9b57016d537acc/holoecho-0.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9a2ae9ead1f763deace4f78e08fa627d973bbdb3253a1ca9740b654c1f488828",
"md5": "a416f9d0bcf1d059e684e8cfb72d9fb5",
"sha256": "6319fde78ff1d9ff1a8a583b6322854c25c781ee3719ae97be60e0fe07efa5b9"
},
"downloads": -1,
"filename": "holoecho-0.2.1.tar.gz",
"has_sig": false,
"md5_digest": "a416f9d0bcf1d059e684e8cfb72d9fb5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 8387,
"upload_time": "2025-08-30T03:18:03",
"upload_time_iso_8601": "2025-08-30T03:18:03.908238Z",
"url": "https://files.pythonhosted.org/packages/9a/2a/e9ead1f763deace4f78e08fa627d973bbdb3253a1ca9740b654c1f488828/holoecho-0.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-30 03:18:03",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "holoecho"
}
JSON