Dragoman Mascot
こんにちは世界
¡Hola Mundo!
Open Source Tool

dragoman

KI-gestützte Übersetzung für strukturierte Dokumente. Beliebiges Dateiformat eingeben — perfekt übersetzte Dateien zurückbekommen, mit jedem Key, Tag und Placeholder intakt.

MIT · Go ·CLI + Library
Scroll
Was ist Dragoman?

Deine Dokumente, jede Sprache

D ragoman ist eine Go-Library und ein CLI-Tool, das strukturierte Dokumente in jedem Dateiformat mit KI übersetzt und dabei die exakte Struktur bewahrt. Keys bleiben Keys, Tags bleiben Tags, Placeholder bleiben unangetastet. Nur der lesbare Text wird übersetzt, mit vollem Context-Verständnis für akkurate, natürliche Ergebnisse.

Ob du eine Nuxt-App mit 27 Sprachdateien pflegst oder ein SaaS-Produkt mit YAML-Configs auslieferst — dragoman übernimmt inkrementelle Updates, Term Preservation und Large-Document Chunking out of the box. Nutze es im Terminal oder integriere es direkt in deine Go-Anwendungen.

So funktioniert's

Drei Schritte zu jeder Sprache

Kein komplexes Setup, keine Konfigurationsdateien. Zeig dragoman dein Dokument und nenne die Zielsprache.

1

Dokument übergeben

Übergib eine beliebige strukturierte Datei. Dragoman erkennt Format und Ausgangssprache automatisch und parst die Dokumentstruktur.

2

KI übersetzt die Werte

Mit OpenAI übersetzt dragoman nur den Textinhalt. Keys, Attribute, Tags und Placeholder bleiben vollständig unangetastet.

3

Übersetzung erhalten

Du erhältst eine perfekt strukturierte Übersetzung — identische Form wie das Original, bereit zum Einfügen in dein Projekt.

en.jsonSource
{
  "greeting": "Hello",
  "farewell": "Goodbye",
  "menu": {
    "home": "Home",
    "about": "About us",
    "contact": "Get in touch"
  }
}
de.jsonTranslated
{
  "greeting": "Hallo",
  "farewell": "Auf Wiedersehen",
  "menu": {
    "home": "Startseite",
    "about": "Über uns",
    "contact": "Kontakt aufnehmen"
  }
}
Features

Gebaut für echte Übersetzungs-Workflows

Structure Preservation

Keys, Tags, Anchors, Attribute und Template-Placeholder bleiben formatunabhängig exakt erhalten. Nur menschenlesbare Werte werden übersetzt.

Multi-Format Support

Funktioniert mit jedem strukturierten Dateiformat out of the box. Erkennt das Format automatisch und verarbeitet verschachtelte Strukturen jeder Tiefe.

Incremental Updates

Nutze den Update-Modus, um nur neue oder fehlende Keys zu übersetzen. Bereits übersetzte Inhalte werden übersprungen — spart Zeit und API-Kosten.

Term Preservation

Halte Markennamen, technische Begriffe und spezifische Phrasen mit dem --preserve Flag bei der Übersetzung unverändert.

Language Auto-Detection

Die Ausgangssprache wird automatisch aus dem Inhalt erkannt. Manuelle Angabe ist nur nötig, wenn du es explizit möchtest.

CLI + Go Library

Nutze dragoman im Terminal für schnelle Übersetzungen oder importiere es als Go-Package und integriere die Übersetzungslogik in deine Anwendungen.

Smart Chunking

Große Dokumente werden automatisch in Chunks aufgeteilt, die in das Context-Window des KI-Modells passen, und dann nahtlos wieder zusammengefügt.

Context-Aware AI

Powered by OpenAI — Übersetzungen verstehen Context, Tonalität und Fachgebiet und liefern natürliche Ergebnisse statt Wort-für-Wort-Ersetzungen.

Unterstützte Formate

Jedes Format, mit dem du arbeitest

Dragoman unterstützt jedes strukturierte Dokumentformat in der modernen Softwareentwicklung.

.json

i18n-Locale-Dateien, API-Responses, Config-Dateien — dragoman bewahrt jeden Key und jede verschachtelte Struktur bei der Übersetzung.

.xml

XLIFF, Android Strings, SVG-Text, SOAP-Payloads — Tags und Attribute bleiben intakt, während Textknoten übersetzt werden.

.yaml

Kubernetes-Configs, Rails-Locales, Hugo-Content-Dateien — Einrückung und Anchors werden perfekt beibehalten.

Command Line

Übersetze aus deinem Terminal

Ein einziger Befehl genügt. Pipe, Redirect oder direkt in Dateien schreiben.

terminal
# Translate a JSON file from English to German
$ dragoman locales/en.json --to de --out locales/de.json

Translating en → de ...
 42 keys translated
 Structure preserved
 Written to locales/de.json

# Only translate new or missing keys
$ dragoman locales/en.json --to de --update locales/de.json

Comparing source with existing translation...
 8 new keys found
 34 keys skipped (already translated)
 Updated locales/de.json

# Preserve specific terms during translation
$ dragoman config.yaml --to ja --preserve "Dragoman,API,OAuth"

Translating en → ja ...
 Terms preserved: Dragoman, API, OAuth
 Written to stdout

Installation via Go

go install github.com/modernice/dragoman/cmd/dragoman@latest
Open Source

Frei und Open Source

dragoman ist MIT-lizenziert und wird aktiv gepflegt. Contributions, Issues und Feedback sind immer willkommen.

Lizenz

MIT

Sprache

Go

Commits

171+

Formate

JSON, XML, YAML

Auf GitHub ansehen

Häufig gestellte Fragen

Alles, was du über dragoman wissen musst.

Dragoman nutzt die OpenAI API (GPT-Modelle) für Übersetzungen. Du brauchst einen OpenAI API Key als OPENAI_API_KEY Umgebungsvariable.

Ja. Nutze das --update Flag, um nur neue oder fehlende Keys in einer bestehenden Übersetzungsdatei zu übersetzen. Bereits übersetzte Inhalte bleiben erhalten.

Absolut. Nutze das --preserve Flag gefolgt von einer kommaseparierten Liste von Begriffen. Markennamen, technische Terme oder beliebige Phrasen bleiben unverändert.

Dragoman teilt große Dokumente automatisch in Chunks auf, die in das Context-Window des Modells passen, übersetzt jeden Chunk und fügt das Ergebnis zu einer einzigen Ausgabe zusammen.

Ja. Importiere github.com/modernice/dragoman und nutze es programmatisch in deinen Go-Anwendungen. Die Library bietet die gleiche Funktionalität wie das CLI.

Dragoman selbst ist kostenlos und MIT-lizenziert. Allerdings nutzt es die OpenAI API für Übersetzungen, die ein eigenes nutzungsbasiertes Pricing hat.

Nimm Kontakt mit uns auf

Du kennst nun unseren Prozess, jetzt ist der nächste Schritt an der Reihe. Lass uns gemeinsam daran arbeiten, deine Online-Präsenz auf das nächste Level zu bringen. Warte nicht länger, vereinbare noch heute ein Gespräch mit uns und wir schauen, wie wir deinem Business mehr Sichtbarkeit verschaffen können.