Install: /plugin install aio-epub-translate@aiocean-plugins · v4.0.0

aio-epub-translate

AI-powered EPUB book translation for Claude Code.

Translate entire books with literary-quality Vietnamese using Claude as your translator. Upload EPUBs, translate chapter by chapter with cross-chapter consistency, automatically detect poor translations, and export polished bilingual or Vietnamese-only EPUBs.

Why this plugin?

Traditional machine translation treats each paragraph in isolation. This plugin treats translation as a literary craft:

• Claude reads the full chapter context before translating
• A glossary of recurring terms is automatically extracted from previous chapters
• Translation follows the Tin-Dat-Nha framework (faithfulness, comprehensibility, elegance)
• Batch API submits all translations in a single request instead of one-by-one
• Quality detection catches mixed-language text, suspiciously short translations, and untranslated passages

Installation

# Add the marketplace (one-time)
/plugin marketplace add aiocean/claude-plugins

# Install the plugin
/plugin install aio-epub-translate@aiocean-plugins

Skills

The plugin includes 6 skills that form a complete translation pipeline. Each skill cross-references the others, so Claude always knows what to suggest next.

aio-epub-setup → aio-epub-upload → aio-epub-translate → aio-epub-quality → aio-epub-export
                                          ↕
                                   aio-epub-manage

aio-epub-setup

"setup epub", "cai dat epub", "configure api key"

First-time setup: register an account at read.aiocean.io, purchase a license, and configure your API key. Includes connection verification and model configuration.

aio-epub-upload

"upload epub", "tai sach len", "prepare book"

Upload an EPUB file to the server. Automatically unpacks, cleans HTML, marks translatable content, and generates AI translation guidelines tailored to the book's style and genre.

aio-epub-translate

"dich sach", "translate chapter", "dich tiep", "translate book"

The core translation skill. For each chapter:

1. Fetches cross-chapter context via GetChapterContext API — previous chapter summary, recurring term glossary, book-level and chapter-level guidelines
2. Loads content via GetPageJson — structured JSON with original text and existing translations
3. Claude translates following literary Vietnamese principles — Topic-Comment structure, active voice, rhythmic balance, idiomatic expressions
4. Batch submits via BatchCreateManualTranslation — all translations in a single API call

Translation principles built into the skill:

aio-epub-quality

"check quality", "kiem tra chat luong", "find bad translations"

Runs automated quality analysis on translations. Detects:

Returns a quality score (0-100%) and can automatically re-translate flagged items.

aio-epub-manage

"list books", "check progress", "update guideline", "book info"

The hub skill for book management:

• List all books on the server
• View table of contents with file paths
• Check translation progress per chapter (with completion indicators)
• View, update, or AI-generate translation guidelines
• Reset chapters for re-translation
• Delete books

aio-epub-export

"export epub", "xuat sach", "pack epub", "send to kindle"

Export translated books in two formats:

Supports sending directly to Kindle via email.

API

The plugin communicates with the translation server via ConnectRPC (JSON over HTTP POST).

Server: https://read-api.aiocean.devWeb app: https://read.aiocean.io

Example workflow

You: upload this book [attaches file.epub]
     → aio-epub-upload handles upload, marking, guideline generation

You: translate chapter 3
     → aio-epub-translate fetches context, translates, submits batch

You: check quality of the whole book
     → aio-epub-quality scans all chapters, reports issues

You: re-translate the bad ones
     → aio-epub-translate re-translates flagged items

You: export as vietnamese-only epub
     → aio-epub-export packs clean EPUB, provides download link

Requirements

• Claude Code with plugin support
• A license key from read.aiocean.io
• AIO_EPUB_API_KEY environment variable set with your license key

Skills (9)

• aio-epub-analyze — Pre-translation analysis for EPUB books — analyze writing style, characters, tone, and build glossary before translating.
• aio-epub-export — Pack and export translated EPUB books as bilingual or translation-only output.
• aio-epub-manage — Browse books, check translation progress, manage guidelines, view TOC, fork books, publish to community, reset chapters, and view usage stats.
• aio-epub-quality — Check translation quality and find chapters that need re-translation.
• aio-epub-review — Deep literary review of translated EPUB chapters — evaluate translation quality, fix consistency issues, and check cross-chapter coherence.
• aio-epub-setup — Setup guide for EPUB translation service — register account, purchase license, and configure API key.
• aio-epub-translate — Translate EPUB book chapters with literary Vietnamese quality via ConnectRPC API.
• aio-epub-upload — Upload and prepare EPUB books for translation.
• aio-epub-vn-style — Vietnamese literary translation style guide — word choice, sentence rhythm, genre conventions, and common error patterns for natural Anh-Viet translation.