Installation
Voraussetzungen
- Node.js 20.11+ (natives ESM)
- Ein Übersetzungs-API-Schlüssel (siehe unten)
Installation
- npm
- npx (no install)
- pnpm
- yarn
npm install --save-dev champollion
npx champollion sync
pnpm add -D champollion
yarn add --dev champollion
Einen API-Schlüssel erhalten
Champollion benötigt ein Übersetzungs-Backend. Wählen Sie eines aus:
| Anbieter | Umgebungsvariable | Am besten geeignet für |
|---|---|---|
| OpenRouter (empfohlen) | OPENROUTER_API_KEY | Inhaltsintensive Projekte, Markdown, 200+ Modelle |
| Gemini (kostenlose Stufe) | GEMINI_API_KEY | Kostenloser Einstieg, gute Qualität |
| OpenAI | OPENAI_API_KEY | Direkter GPT-4o-Zugriff |
| Anthropic | ANTHROPIC_API_KEY | Direkter Claude-Zugriff, nuancierter Text |
| DeepL | DEEPL_API_KEY | Europäische Sprachen, integrierte Formalität |
| Google Translate | GOOGLE_TRANSLATE_API_KEY | Große Mengen an Schlüssel-Wert-Paaren, 130+ Sprachen |
| Microsoft Translator | MICROSOFT_TRANSLATOR_API_KEY | Azure, 100+ Sprachen |
| LibreTranslate | LIBRETRANSLATE_API_URL | Selbst gehostet, datenschutzorientiert |
- OpenRouter (recommended)
- Google Translate
OpenRouter stellt eine einheitliche API für 200+ LLM-Modelle bereit. Eine kostenlose Stufe ist verfügbar.
# Sign up at https://openrouter.ai, then:
export OPENROUTER_API_KEY=sk-or-v1-...
Oder fügen Sie es zu .env.local hinzu:
OPENROUTER_API_KEY=sk-or-v1-your-key-here
Am besten geeignet für: inhaltsintensive Projekte, Markdown-Übersetzung und Projekte, die eine inhaltsbewusste Abschirmung benötigen (Codeblöcke, Shortcodes, Interpolationsvariablen).
export GOOGLE_TRANSLATE_API_KEY=...
Am besten geeignet für: große Mengen an Schlüssel-Wert-Zeichenkettenpaaren (130+ Sprachen). Nicht empfohlen für Markdown-Inhalte — Google Translate kennt keine Codeblöcke, Shortcodes oder Interpolationsvariablen.
:::tip Intelligente Erkennung
Wenn nur GOOGLE_TRANSLATE_API_KEY gesetzt ist (kein OpenRouter-Schlüssel), wechselt champollion automatisch zu Google Translate. Keine Konfigurationsänderung erforderlich.
:::
Installation überprüfen
npx champollion --help
Sie sollten die Liste der verfügbaren Befehle sehen. Sie sind bereit für den Schnellstart.