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.

⚙️ Prerequisites (one-time setup)

Voicci generates speech locally using XTTS v2, so a small Python environment is needed alongside the npm CLI. Install these once, then you're set for life.

Node.js 22+ · node -v (older versions will not work)
Python 3.10+ · python3 --version
TTS + PyTorch · pip3 install TTS torch (on first audiobook, XTTS v2 weights ~2 GB download automatically)

After install, run voicci doctor — it verifies every prerequisite and prints a PASS/FAIL table.

📦 Quick Install

✨ Works with Claude Code, OpenCode, Cursor, Windsurf & more

Open your terminal and run:

npm install -g voicci

✅ Verify the install

Run this to confirm Node, Python, TTS and the editor skills are all wired up:

                        voicci doctor
                    

🔁 Restart your AI editor after install so it picks up the new /voicci skill.

Where to run this command:

macOS: Open Terminal (Applications → Utilities → Terminal)
Linux: Open your Terminal application
Windows: experimental — WSL2 recommended; native PowerShell may hit PyTorch/TTS build issues

📦 View on npm

✅ After Installation - Usage with AI Editors

🎯 Claude Code (Best Experience)

Open Claude Code and type:

                        /voicci Lord of the Rings
                    

Claude AI will search, download, and convert the book for you automatically!

🤖 OpenCode

Just tell the AI what you want:

"Find and convert 'Attention Is All You Need' paper to audiobook"

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

IMPORTANT: By using Voicci CLI, you agree to use this software responsibly and in compliance with all applicable laws. Fontaine Farm SRL and the Voicci team are not responsible for how you use this tool.

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

BY USING VOICCI CLI, YOU AGREE TO THESE TERMS AND ACCEPT FULL LEGAL RESPONSIBILITY FOR YOUR ACTIONS.

✨ Features

🎧

Audiobook Generation

Convert text and PDF files to natural-sounding audiobooks using XTTS v2 voice synthesis

🤖

AI Text Summarization

Condense long texts into concise summaries using AI-powered analysis

🔒

100% Local Processing

All processing happens on your machine. No data sent to external servers.

⚡

Fast & Efficient

Optimized queue system for processing multiple files concurrently

📖

Multiple Formats

Supports .txt, .pdf, and various text formats as input

🎨

Voice Customization

Use custom voice samples or built-in voices for narration

🚀 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.wav

Summarize Text

Generate an AI summary of a document:

voicci summary article.txt
voicci summary research.pdf --output summary.txt

Options

voicci --help                # Show all available commands
voicci audiobook --help      # Show audiobook-specific options
voicci summary --help        # Show summarization options