Voicci CLI
For Claude Code, OpenCode & AI Code Editors
AI-powered audiobook generation with natural language. Works with Claude Code, OpenCode, Cursor, Windsurf & more. Convert books and PDFs using XTTS v2. 100% local processing.
๐ฆ Quick Install
โจ Works with Claude Code, OpenCode, Cursor, Windsurf & more
Open your terminal and run:
Where to run this command:
- macOS: Open Terminal (Applications โ Utilities โ Terminal)
- Windows: Open Command Prompt or PowerShell
- Linux: Open your Terminal application
โ After Installation - Usage with AI Editors
๐ฏ Claude Code (Best Experience)
Open Claude Code and type:
Claude AI will search, download, and convert the book for you automatically!
๐ค OpenCode
Just tell the AI what you want:
OpenCode will understand and run the voicci commands for you.
๐ฌ Cursor / Windsurf / Other AI Editors
Use natural language:
"Convert this PDF to an audiobook"
"Find a book about machine learning"
"Summarize this paper for me"
Your AI assistant will intelligently use voicci commands to help you.
๐ก Why Use AI Editors?
- AI handles book search and selection intelligently
- Automatic error troubleshooting and retries
- Natural language - no need to remember commands
- Progress monitoring and status updates
- Smart summarization and content analysis
โ ๏ธ Legal Disclaimer & Terms of Use
1. Intended Use
Voicci CLI is designed for:
- Converting legally obtained text and PDF files to audiobooks
- Processing public domain works
- Converting personal documents you own or have permission to use
- Academic research with properly licensed materials
- Accessibility purposes for content you have rights to
2. Copyright & Legal Responsibility
You are solely responsible for ensuring you have the legal right to use any content processed by Voicci CLI.
- Do NOT use this tool to download, convert, or distribute copyrighted materials without authorization
- Do NOT request, search for, or download copyrighted books, papers, or documents that you do not have rights to
- Copyright infringement is illegal and may result in civil and criminal penalties
- Users must comply with their country's copyright laws (e.g., DMCA in USA, Copyright Act in UK, etc.)
3. Book Search Functionality
The book search feature is provided for:
- Public domain works only (books published before 1928 in USA, or confirmed public domain)
- Locating legally free academic papers and research
- Finding books you already own in physical or digital format
We explicitly prohibit:
- Using the search feature to download copyrighted books without authorization
- Circumventing paywalls or digital rights management (DRM)
- Downloading content from unauthorized sources
4. No Liability
Fontaine Farm SRL, the Voicci development team, and contributors:
- Do NOT endorse, encourage, or support copyright infringement
- Are NOT responsible for how users choose to use this software
- Are NOT liable for any legal consequences resulting from user misuse
- Provide this tool "AS IS" without warranties of any kind
5. User Responsibility
By installing and using Voicci CLI, you acknowledge and agree that:
- You will only process content that you have legal rights to use
- You will not use this tool for illegal activities
- You understand the copyright laws in your jurisdiction
- You accept full responsibility for your actions
- The developers are not liable for your misuse of the software
6. Third-Party Sources
This tool may reference or access third-party sources. We:
- Do NOT host any copyrighted content
- Do NOT control what content is available on external sources
- Are NOT affiliated with any book repositories or libraries
- Recommend using only legal, authorized sources for content
7. Violation Reporting
If you believe this tool is being used to infringe your copyright:
- Contact us at: info@autogcode.com
- We take copyright infringement seriously and will investigate reports
- Provide specific details about the alleged infringement
โจ Features
๐ Usage
Convert Your Own Files
Convert text or PDF files that you own or have permission to use:
voicci mybook.pdf
voicci document.txt --voice custom_voice.wavSummarize Text
Generate an AI summary of a document:
voicci summary article.txt
voicci summary research.pdf --output summary.txtOptions
voicci --help # Show all available commands
voicci audiobook --help # Show audiobook-specific options
voicci summary --help # Show summarization options๐ Requirements
Voicci CLI requires:
- Node.js v16 or higher
- Python 3.8+ (for XTTS v2 voice synthesis)
- 4GB RAM minimum (8GB recommended for faster processing)
- Storage: ~2GB for voice models and dependencies
Platform Support
- โ macOS (Intel & Apple Silicon)
- โ Linux (Ubuntu, Debian, Fedora)
- โ Windows (with WSL2 recommended)
๐ Links & Support
๐๏ธ Looking for Real-Time Voice to Text?
Check out our Voicci Mac App for instant voice transcription with a simple keyboard shortcut.