Available on npm

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:

npm install -g voicci

Where to run this command:

  • macOS: Open Terminal (Applications โ†’ Utilities โ†’ Terminal)
  • Windows: Open Command Prompt or PowerShell
  • Linux: Open your Terminal application
๐Ÿ“ฆ 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

โœจ 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

๐Ÿ“‹ 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

๐Ÿ“ฆ
NPM Package
๐Ÿ’ป
GitHub Repository
๐Ÿ›
Report Issues
๐Ÿ“ง
Contact

๐ŸŽ™๏ธ Looking for Real-Time Voice to Text?

Check out our Voicci Mac App for instant voice transcription with a simple keyboard shortcut.

Try Voicci Mac App Free