Team Ai
Modelpublic

Thalesian/cuneiformBase-400m

sourceHugging Faceapache-2.0updated 8mo agoView on Hugging Face
5likes84downloads
Model Card

cuneiformBase-400m

Introducing cuneiformBase-400m, a multilingual model capable of handling translation, transliteration, and script conversion tasks across multiple ancient languages: Akkadian, Sumerian, Hittite, Linear B, and Elamite.

1. Model Description

This is an instruct model based on Google's umt5-base (768 hidden dimensions, 12 encoder layers, 12 decoder layers). Unlike the original UMT5 architecture which uses untied input/output embeddings, this model uses tied embeddings (~396M parameters). It supports translation to and from English (and German for Hittite), transliteration between cuneiform signs and Latin characters, and script conversion across five ancient writing systems.

Three styles of transliteration are supported where applicable:

  • β€”Plain transliteration -- standard scholarly transliteration following CDLI notation style
  • β€”Complex transliteration -- includes special symbols, subscript numbers, and determinatives
  • β€”Simple transliteration -- stripped of all special symbols and diacritics, syllables merged to form words

Akkadian Instructions

Translation:

PromptInputOutput
Translate Akkadian cuneiform to English:cuneiform signsEnglish
Translate Akkadian transliteration to English:transliterationEnglish
Translate complex Akkadian transliteration to English:complex transliterationEnglish
Translate simple Akkadian transliteration to English:simple transliterationEnglish
Translate English to Akkadian cuneiform:Englishcuneiform signs
Translate English to Akkadian transliteration:Englishtransliteration
Translate English to complex Akkadian transliteration:Englishcomplex transliteration
Translate English to simple Akkadian transliteration:Englishsimple transliteration

Transliteration:

PromptInputOutput
Transliterate Akkadian cuneiform to Latin characters:cuneiform signstransliteration
Transliterate Akkadian cuneiform to complex Latin characters:cuneiform signscomplex transliteration
Transliterate Akkadian cuneiform to simple Latin characters:cuneiform signssimple transliteration

Script Conversion:

PromptInputOutput
Convert transliterated Latin characters to Akkadian cuneiform:transliterationcuneiform signs
Convert complex transliterated Latin characters to Akkadian cuneiform:complex transliterationcuneiform signs
Convert simple transliterated Latin characters to Akkadian cuneiform:simple transliterationcuneiform signs

Sumerian Instructions

Translation:

PromptInputOutput
Translate Sumerian cuneiform to English:cuneiform signsEnglish
Translate Sumerian transliteration to English:transliterationEnglish
Translate complex Sumerian transliteration to English:complex transliterationEnglish
Translate simple Sumerian transliteration to English:simple transliterationEnglish
Translate English to Sumerian cuneiform:Englishcuneiform signs
Translate English to Sumerian transliteration:Englishtransliteration

Transliteration:

PromptInputOutput
Transliterate Sumerian cuneiform to Latin characters:cuneiform signstransliteration
Transliterate Sumerian cuneiform to complex Latin characters:cuneiform signscomplex transliteration

Script Conversion:

PromptInputOutput
Convert transliterated Latin characters to Sumerian cuneiform:transliterationcuneiform signs

Hittite Instructions

Translation:

PromptInputOutput
Translate Hittite transliteration to English:transliterationEnglish
Translate complex Hittite transliteration to English:complex transliterationEnglish
Translate simple Hittite transliteration to English:simple transliterationEnglish
Translate Hittite transliteration to German:transliterationGerman
Translate complex Hittite transliteration to German:complex transliterationGerman
Translate simple Hittite transliteration to German:simple transliterationGerman
Translate English to Hittite transliteration:Englishtransliteration
Translate German to Hittite transliteration:Germantransliteration

Linear B Instructions

Translation:

PromptInputOutput
Translate Linear B cuneiform to English:Linear B signsEnglish
Translate Linear B transliteration to English:transliterationEnglish
Translate complex Linear B transliteration to English:complex transliterationEnglish
Translate simple Linear B transliteration to English:simple transliterationEnglish
Translate English to Linear B cuneiform:EnglishLinear B signs
Translate English to Linear B transliteration:Englishtransliteration

Transliteration:

PromptInputOutput
Transliterate Linear B cuneiform to Latin characters:Linear B signstransliteration

Script Conversion:

PromptInputOutput
Convert transliterated Latin characters to Linear B cuneiform:transliterationLinear B signs

Elamite

Elamite was included in training on a limited corpus. Due to insufficient validation data, no evaluation metrics are reported for Elamite at this time. Use with caution and expect lower accuracy than the other supported languages.


Base Model

This is a finetuned version of Google's umt5-base, but with tied embeddings.

2. Usage

python
from transformers import AutoTokenizer, AutoModelForSeq2SeqLM

model_path = "Thalesian/cuneiformBase-400m"
tokenizer = AutoTokenizer.from_pretrained(model_path, use_fast=False)
model = AutoModelForSeq2SeqLM.from_pretrained(model_path)

# Example: Translate Akkadian cuneiform to English
prompt = "Translate Akkadian cuneiform to English: "
input_text = "π’…† 𒁹 π’€­ π’‰Ί 𒉽 π’€€ 𒁹 π’„Ώ π’Œ‹ π’Š 𒀴 𒃻 π’€€ π’Œ‹ π’Œ‹ π’€€ π’Œ‹ π’Œ‹"

inputs = tokenizer(prompt + input_text, return_tensors="pt")
outputs = model.generate(**inputs, max_length=64)

prediction = tokenizer.decode(outputs[0], skip_special_tokens=True)
print("Prediction:", prediction)
> "witness  Nabu-naαΉ£ir  son  Na  di-Issar  servant  of  son  king"

3. Training and Evaluation Data

Data was used from the Akkademia project, previously published in PNAS Nexus. Additional data for pre-training and training came from CDLI data for Akkadian and Sumerian, the OARE dataset for Akkadian, Hittite data from the HPM corpus, Linear B data from published syllabary resources, and a limited Elamite corpus. More information on the training data, as well as the test and validation splits, can be found on both the GitHub and published methodology.

Training Procedure

The model was trained in multiple stages with different datasets and collators across all supported languages.

Framework Versions

  • β€”Transformers 5.0.0.dev0
  • β€”PyTorch 2.6.0+cu126
  • β€”Tokenizers 0.21.1

4. Evaluation Metrics

4.1 Akkadian

4.1.1 Akkadian Metrics by Line
From LanguageFrom ScriptTo LanguageTo ScriptBLEUCHRFMETEOR
AkkadianTransliterationAkkadianCuneiform95.7895.33-
AkkadianCuneiformEnglishLatin66.8678.260.78
AkkadianTransliterationEnglishLatin69.7880.560.80
AkkadianComplex TransliterationEnglishLatin69.7880.580.80
AkkadianSimple TransliterationEnglishLatin67.6578.700.78
EnglishLatinAkkadianCuneiform45.6145.48-
EnglishLatinAkkadianTransliteration43.5465.42-
AkkadianCuneiformAkkadianTransliteration83.6392.22-
4.1.2 Akkadian Metrics by Document
From LanguageFrom ScriptTo LanguageTo ScriptBLEUCHRFMETEOR
AkkadianTransliterationAkkadianCuneiform39.4750.44-
AkkadianCuneiformEnglishLatin34.1451.540.49
AkkadianTransliterationEnglishLatin35.9453.190.50
AkkadianComplex TransliterationEnglishLatin36.1753.460.51
AkkadianSimple TransliterationEnglishLatin33.9551.610.49
EnglishLatinAkkadianCuneiform24.1429.94-
EnglishLatinAkkadianTransliteration18.8435.57-
AkkadianCuneiformAkkadianTransliteration26.1341.81-
4.1.3 Akkadian Metrics by Line (CDLI Test Set)
From LanguageFrom ScriptTo LanguageTo ScriptBLEUCHRFMETEOR
AkkadianTransliterationAkkadianCuneiform29.7946.17-
AkkadianComplex TransliterationAkkadianCuneiform32.0547.47-
AkkadianSimple TransliterationAkkadianCuneiform16.9724.64-
AkkadianCuneiformEnglishLatin20.7446.630.41
AkkadianTransliterationEnglishLatin24.1051.150.45
AkkadianComplex TransliterationEnglishLatin23.9951.300.45
AkkadianSimple TransliterationEnglishLatin20.7446.850.40
EnglishLatinAkkadianTransliteration29.4560.35-
EnglishLatinAkkadianComplex Transliteration18.0647.32-
EnglishLatinAkkadianSimple Transliteration2.0225.48-
AkkadianCuneiformAkkadianTransliteration36.7474.18-
AkkadianCuneiformAkkadianComplex Transliteration29.4968.63-
AkkadianCuneiformAkkadianSimple Transliteration1.8030.50-
4.1.4 Akkadian Metrics by Document (CDLI Test Set)
From LanguageFrom ScriptTo LanguageTo ScriptBLEUCHRFMETEOR
AkkadianTransliterationAkkadianCuneiform68.0175.51-
AkkadianComplex TransliterationAkkadianCuneiform67.4074.77-
AkkadianSimple TransliterationAkkadianCuneiform38.0940.73-
AkkadianCuneiformEnglishLatin23.3947.780.44
AkkadianTransliterationEnglishLatin26.2350.910.47
AkkadianComplex TransliterationEnglishLatin25.4150.860.47
AkkadianSimple TransliterationEnglishLatin22.4847.680.44
EnglishLatinAkkadianTransliteration28.8851.57-
EnglishLatinAkkadianComplex Transliteration15.1938.29-
EnglishLatinAkkadianSimple Transliteration1.7523.31-
AkkadianCuneiformAkkadianTransliteration34.4857.21-
AkkadianCuneiformAkkadianComplex Transliteration28.9953.30-
AkkadianCuneiformAkkadianSimple Transliteration1.4224.87-
4.1.5 Akkadian Metrics by Document (OARE Test Set)
From LanguageFrom ScriptTo LanguageTo ScriptBLEUCHRFMETEOR
AkkadianTransliterationAkkadianCuneiform15.5721.40-
AkkadianComplex TransliterationAkkadianCuneiform18.3928.34-
AkkadianSimple TransliterationAkkadianCuneiform10.3515.89-
AkkadianCuneiformEnglishLatin1.7217.530.13
AkkadianTransliterationEnglishLatin0.7817.670.10
AkkadianComplex TransliterationEnglishLatin0.8617.520.11
AkkadianSimple TransliterationEnglishLatin1.5318.320.14
EnglishLatinAkkadianTransliteration0.7716.17-
EnglishLatinAkkadianComplex Transliteration0.5312.87-
EnglishLatinAkkadianSimple Transliteration0.3310.94-
AkkadianCuneiformAkkadianTransliteration0.9619.75-
AkkadianCuneiformAkkadianComplex Transliteration1.3919.28-
AkkadianCuneiformAkkadianSimple Transliteration0.3811.88-

4.2 Sumerian

4.2.1 Sumerian Metrics by Line
From LanguageFrom ScriptTo LanguageTo ScriptBLEUCHRFMETEOR
SumerianTransliterationSumerianCuneiform98.8598.87-
SumerianCuneiformEnglishLatin19.4040.430.38
SumerianTransliterationEnglishLatin23.8146.000.45
SumerianComplex TransliterationEnglishLatin23.9645.880.45
SumerianSimple TransliterationEnglishLatin21.5343.430.41
EnglishLatinSumerianCuneiform52.2855.05-
EnglishLatinSumerianTransliteration42.0262.72-
SumerianCuneiformSumerianTransliteration39.0864.61-
SumerianCuneiformSumerianComplex Transliteration37.6663.61-
4.2.2 Sumerian Metrics by Document
From LanguageFrom ScriptTo LanguageTo ScriptBLEUCHRFMETEOR
SumerianTransliterationSumerianCuneiform78.7483.74-
SumerianCuneiformEnglishLatin24.9945.430.43
SumerianTransliterationEnglishLatin30.3450.820.51
SumerianComplex TransliterationEnglishLatin30.4350.580.50
SumerianSimple TransliterationEnglishLatin26.1547.910.45
EnglishLatinSumerianCuneiform52.5855.17-
EnglishLatinSumerianTransliteration48.3562.48-
SumerianCuneiformSumerianTransliteration39.8858.59-
SumerianCuneiformSumerianComplex Transliteration37.7857.10-

4.3 Hittite

4.3.1 Hittite Metrics by Line
From LanguageFrom ScriptTo LanguageTo ScriptBLEUCHRFMETEOR
HittiteTransliterationEnglishLatin95.6297.410.97
HittiteComplex TransliterationEnglishLatin95.0897.050.97
HittiteSimple TransliterationEnglishLatin93.4596.190.96
HittiteTransliterationGermanLatin86.8894.250.93
HittiteComplex TransliterationGermanLatin86.6494.070.92
HittiteSimple TransliterationGermanLatin79.8291.130.89
EnglishLatinHittiteTransliteration55.8984.47-
GermanLatinHittiteTransliteration49.1883.33-
4.3.2 Hittite Metrics by Document
From LanguageFrom ScriptTo LanguageTo ScriptBLEUCHRFMETEOR
HittiteTransliterationEnglishLatin65.2372.790.70
HittiteComplex TransliterationEnglishLatin65.3973.060.71
HittiteSimple TransliterationEnglishLatin63.6171.940.69
HittiteTransliterationGermanLatin56.0168.220.65
HittiteComplex TransliterationGermanLatin56.4768.870.66
HittiteSimple TransliterationGermanLatin49.3264.910.62
EnglishLatinHittiteTransliteration28.3847.49-
GermanLatinHittiteTransliteration24.2445.63-

The Hittite validation scripts were based on CTH numbers - however the English bleu score for lines (95.62) is implausibly high - we believe there was data leakage for a manually generated training set. This may impact the German as well, but German scores are consistent with past models deployed before the additional English set.


4.4 Linear B

Note: Line-level and document-level metrics are identical for Linear B, as the validation set consists of single-line documents.

4.4.1 Linear B Metrics
From LanguageFrom ScriptTo LanguageTo ScriptBLEUCHRFMETEOR
Linear BTransliterationLinear BSyllabary86.2488.29-
Linear BSyllabaryEnglishLatin50.4162.820.67
Linear BTransliterationEnglishLatin56.5166.230.70
Linear BComplex TransliterationEnglishLatin68.3373.420.78
Linear BSimple TransliterationEnglishLatin28.2444.500.50
EnglishLatinLinear BSyllabary50.7652.18-
EnglishLatinLinear BTransliteration52.2164.18-
Linear BSyllabaryLinear BTransliteration50.9873.45-

4.5 Elamite

Elamite was included during training on a limited corpus. Due to insufficient validation data, no evaluation metrics are available. Results should be treated as experimental.

5. Intended Uses

  • β€”Translation of short cuneiform lines across Akkadian, Sumerian, Hittite, and Linear B
  • β€”Transliteration pipelines converting between cuneiform signs and Latin-script representations
  • β€”Reverse translation from English/German back to ancient language transliterations or cuneiform
  • β€”Comparative studies across multiple ancient writing systems
  • β€”Educational and research applications in digital Assyriology, Sumerology, Hittitology, and Aegean scripts

6. Limitations

  • β€”Context window is limited to 512 tokens; longer texts should be split into individual lines.
  • β€”Sumerian translation quality is notably lower than other languages due to the complexity and limited parallel data for Sumerian.
  • β€”Elamite support is experimental with minimal training data.
  • β€”OARE out-of-domain Akkadian data shows significantly degraded performance, indicating domain sensitivity.
  • β€”The model was trained on scholarly transliterations and may not generalize well to non-standard input formats.
  • β€”Linear B prompts use the term "cuneiform" for the syllabary script for consistency with the prompt format; Linear B is a syllabic script, not cuneiform.

7. How to Cite

bibtex
@misc{drake2025cuneiformBase400m,
  title        = {{cuneiformBase-400m}: A Multilingual T5 Model for Ancient Script Translation and Transliteration},
  author       = {Drake, B. Lee},
  year         = {2025},
  howpublished = {\url{https://huggingface.co/Thalesian/cuneiformBase-400m}}
}