Downloads · 30 days
77
39% of all-time downloads
wjhuah/BIRD
BIRD is a fill-mask model from wjhuah. Use it when you need the model to fill a missing word. It is set up for transformers. The card lists the license as cc-by-4.0.
《詩·商頌·玄鳥》:天命玄鳥,降而生商 “Heaven commissioned the swallow, to descend and give birth to Shang.” — translated by James Legge
Downloads · 30 days
77
39% of all-time downloads
All-time downloads
195
Public
Parameters
109M
874 MB on disk
Likes
2
Public
Click a slice to open those files.
.safetensors437 MB · 100%
From the Hugging Face model README
《詩·商頌·玄鳥》:天命玄鳥,降而生商
“Heaven commissioned the swallow, to descend and give birth to Shang.”
— translated by James Legge
This model is adapted from SIKU-BERT/sikuroberta, with additional domain-adaptive pretraining (DAPT), task-adaptive pretraining (TAPT), and integration of a Glyph Net (GN) module.
It is trained on the BIRD (Bronze Inscription Restoration and Dating), the first fully encoded bronze inscription corpus with chronological labels.
The model was trained on the BIRD dataset:
[UNK] placeholders for undeciphered glyphsDataset repo: wjhuah/BIRD
We employed the SikuRoBERTa (GN) model with two decoding strategies:
parallel mask filling and greedy iterative decoding.
The table below compares predicted tokens with expert gold restorations.
(excerpt of the first six damaged positions in the Hu Ding inscription)
| Mask Position | Gold | Pred@1 | Top-5 Predictions |
|---|---|---|---|
| 01 | 室 | 廟 | 廟, 室, 宮, 寢, 廷 |
| 02 | 王 | 王 | 王, 公, 君, 伯, 尹 |
| 03 | 芾 | 芾 | 芾, 純, 衡, 衣, 韍 |
| 05 | 命 | 於 | 於, 于, 揚, 無, 多 |
| 06 | 于 | 于 | 于, 揚, 穆, 於, 侑 |
| 07 | 年 | 年 | 年, 人, 世, 壽, 歲 |
On 22 expert restorations (Huang, 2022), the model achieved:
Greedy decoding yielded comparable coverage, though with slightly lower accuracy.
In addition to reproducing expert restorations, the system also generated plausible candidates for undeciphered characters, providing potential references for paleographic analysis.
| Mask Position | Top-10 Predictions |
|---|---|
| 04 | 鑾, 旂, 舄, 筆, 㫃, 金, 矢, 黃, 弓, 璋 |
| 08 | 介, 伯, 市, 限, 客, 期, 制, 政, 宰, 人 |
| 15 | 之, 外, 一, 若, 內, 賜, 邑, 大, 下, 又 |
| 16 | 賜, 折, 喬, 杜, 乘, 造, 擇, 柞, 之, 于 |
| 17 | 則, 許, 弗, 不, 人, 亦, 也, 而, 帛, 乃 |
| 18 | 則, 曰, 不, 弗, 許, 告, 厥, 多, 有, 用 |
| 28 | 其, 厥, 若, 越, 乃, 我, 以, 汝, 如, 余 |
A minimal example for masked language modeling:
from transformers import AutoTokenizer, AutoModelForMaskedLM
model_name = "wjhuah/BIRD"
tokenizer = AutoTokenizer.from_pretrained(model_name)
model = AutoModelForMaskedLM.from_pretrained(model_name)
text = "唯王元年六月既朢乙亥,王在周穆王太[mask]"
inputs = tokenizer(text, return_tensors="pt")
outputs = model(**inputs)
If you use this model, please cite our EMNLP 2025 paper:
@inproceedings{hua2025bird,
title = {BIRD: Bronze Inscription Restoration and Dating},
author = {Hua, Wenjie and Nguyen, Hoang H. and Ge, Gangyan},
booktitle = {Proceedings of the 2025 Conference on Empirical Methods in Natural Language Processing},
year = {2025},
publisher = {Association for Computational Linguistics}
}