Ever wished your favorite books could talk to you? 🤩 Chatterblez is here to make that dream a reality! 🪄 We leverage the cutting-edge Next-gen AI Chatterbox-tts from Resemble-AI (check them out!) to generate high-quality audiobooks directly from your PDF or EPUB files. 📚➡️🔊
Inspired by the awesome work of audiblez, Chatterblez takes text-to-speech to the next level, offering a seamless and delightful listening experience. 💖
Tested and running smoothly on:
- Windows 11 🪟
- Python 3.12 🐍
- NVIDIA CUDA 12.4: Required for GPU acceleration and optimal performance. Please ensure you have a compatible NVIDIA graphics card and the necessary CUDA drivers installed. 🚀
Ready to dive in? Here's how to get Chatterblez up and running on your machine:
git clone https://github.com/cpttripzz/ChatterblezIf you have an NVIDIA GPU, install CUDA for optimal performance. This significantly speeds up the AI processing!
- Download CUDA 12.4: https://developer.nvidia.com/cuda-12-4-0-download-archive?target_os=Windows&target_arch=x86_64&target_version=11&target_type=exe_local
- Follow the installation instructions provided by NVIDIA. 🧑💻
Navigate into the cloned directory and install the required Python packages:
cd Chatterblez
uv venv --python 3.12 # or however you prefer to create the venv
.venv\Scripts\activate
uv pip install --index-strategy unsafe-best-match -r requirements.txtThis might take a moment, so grab a coffee! ☕
FFmpeg is required for audio processing. Here's how to install it:
🔵 Windows:
-
Download a static build from https://www.gyan.dev/ffmpeg/builds/
-
Extract the
.zipto a location likeC:\ffmpeg -
Add the
C:\ffmpeg\binpath to your System Environment Variables:- Search "Edit the system environment variables" from the Start Menu
- Click "Environment Variables..."
- Under "System Variables", find
Path, click Edit..., then New, and paste thebinfolder path
-
Open a new Command Prompt and run:
ffmpeg -version
You should see FFmpeg version info.
🟢 Linux (Ubuntu):
sudo apt update && sudo apt upgrade -y
sudo apt install ffmpeg -y
ffmpeg -version🟣 macOS (with Homebrew):
brew install ffmpeg
ffmpeg -versionDetailed usage instructions, including how to convert your first PDF or EPUB, will be added here shortly! Stay tuned! ⏳
- Resemble-AI for their incredible Chatterbox-tts project. They're making AI voices sound truly human! 🗣️
- santinic for the inspiration from audiblez. Great minds think alike! 💡
Got ideas? Found a bug? Want to make Chatterblez even better? We'd love your contributions! Please feel free to open an issue or submit a pull request. Let's build something amazing together! 🤝
[Add your license information here, e.g., MIT License]
Made with ❤️ by cpttripzz ✨ Happy listening! 🎧📖💖
Let me know if you’d like to add demo commands, screenshots, or a chatterblez.py usage example next.