Installatie

Vereisten

• Node.js 20.11+ (native ESM)
• Een vertaal-API-sleutel (zie hieronder)

Installeren

npm

npm install --save-dev champollion

npx (no install)

npx champollion sync

pnpm

pnpm add -D champollion

yarn

yarn add --dev champollion

Een API-sleutel verkrijgen

Champollion heeft een vertaalbackend nodig. Kies er een:

Aanbieder	Omgevingsvariabele	Geschikt voor
OpenRouter (aanbevolen)	OPENROUTER_API_KEY	Inhoudsintensieve projecten, Markdown, 200+ modellen
Gemini (gratis laag)	GEMINI_API_KEY	Kosteloos starten, goede kwaliteit
OpenAI	OPENAI_API_KEY	Directe GPT-4o-toegang
Anthropic	ANTHROPIC_API_KEY	Directe Claude-toegang, genuanceerde tekst
DeepL	DEEPL_API_KEY	Europese talen, ingebouwde formaliteit
Google Translate	GOOGLE_TRANSLATE_API_KEY	Grootschalige sleutel-waardeparen, 130+ talen
Microsoft Translator	MICROSOFT_TRANSLATOR_API_KEY	Azure, 100+ talen
LibreTranslate	LIBRETRANSLATE_API_URL	Zelfgehost, privacy voorop

OpenRouter (recommended)

OpenRouter biedt een uniforme API voor 200+ LLM-modellen. Gratis laag beschikbaar.

# Sign up at https://openrouter.ai, then:
export OPENROUTER_API_KEY=sk-or-v1-...

Of voeg toe aan .env.local:

OPENROUTER_API_KEY=sk-or-v1-your-key-here

Geschikt voor: inhoudsintensieve projecten, Markdown-vertaling, en projecten die inhoudsbewuste afscherming nodig hebben (codeblokken, shortcodes, interpolatievariabelen).

Google Translate

export GOOGLE_TRANSLATE_API_KEY=...

Geschikt voor: grootschalige sleutel-waardeparen (130+ talen). Niet aanbevolen voor Markdown-inhoud — Google Translate heeft geen bewustzijn van codeblokken, shortcodes of interpolatievariabelen.

:::tip Slimme detectie Als alleen GOOGLE_TRANSLATE_API_KEY is ingesteld (geen OpenRouter-sleutel), schakelt champollion automatisch over naar Google Translate. Er is geen configuratiewijziging nodig. :::

Installatie verifiëren

npx champollion --help

U zou de lijst met beschikbare opdrachten moeten zien. U bent klaar voor de Snelle start.