{"id":13615285,"url":"https://github.com/Ethan-yt/guwenbert","last_synced_at":"2025-04-13T21:30:39.263Z","repository":{"id":96172541,"uuid":"307315411","full_name":"Ethan-yt/guwenbert","owner":"Ethan-yt","description":"GuwenBERT: 古文预训练语言模型（古文BERT）  A Pre-trained Language Model for Classical Chinese (Literary Chinese)","archived":false,"fork":false,"pushed_at":"2021-08-31T09:11:28.000Z","size":2211,"stargazers_count":503,"open_issues_count":2,"forks_count":40,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-11-07T23:39:17.774Z","etag":null,"topics":["bert","classical-chinese","guwenbert","literary-chinese","transformers"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Ethan-yt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-10-26T09:06:37.000Z","updated_at":"2024-11-03T02:28:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"f5037cb5-c0be-4a71-84cd-389b6740c1ef","html_url":"https://github.com/Ethan-yt/guwenbert","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ethan-yt%2Fguwenbert","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ethan-yt%2Fguwenbert/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ethan-yt%2Fguwenbert/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ethan-yt%2Fguwenbert/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ethan-yt","download_url":"https://codeload.github.com/Ethan-yt/guwenbert/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248785893,"owners_count":21161369,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bert","classical-chinese","guwenbert","literary-chinese","transformers"],"created_at":"2024-08-01T20:01:11.505Z","updated_at":"2025-04-13T21:30:37.932Z","avatar_url":"https://github.com/Ethan-yt.png","language":null,"funding_links":[],"categories":["Pretrained Language Model","Others"],"sub_categories":["Repository"],"readme":"[**中文说明**](https://github.com/ethan-yt/guwenbert/) | [English](https://github.com/ethan-yt/guwenbert/blob/master/README_EN.md)\n\n\u003cp align=\"center\"\u003e\n    \u003cbr\u003e\n    \u003cimg src=\"./assets/GuwenBERT.png\" width=\"500\"/\u003e\n    \u003cbr\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/ethan-yt/guwenbert/issues\"\u003e\u003cimg alt=\"GitHub issues\" src=\"https://img.shields.io/github/issues/ethan-yt/guwenbert\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/ethan-yt/guwenbert/stargazers\"\u003e\u003cimg alt=\"GitHub stars\" src=\"https://img.shields.io/github/stars/ethan-yt/guwenbert\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Ethan-yt/guwenbert/blob/main/LICENSE\"\u003e\u003cimg alt=\"GitHub license\" src=\"https://img.shields.io/github/license/ethan-yt/guwenbert\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n`GuwenBERT`是一个基于大量古文语料的`RoBERTa`模型。\n\n在自然语言处理领域中，预训练语言模型（Pre-trained Language Models）已成为非常重要的基础技术。\n目前互联网上存在大量的现代汉语BERT模型可供下载，但是缺少古文的语言模型。\n为了进一步促进古文研究和自然语言处理的结合，我们发布了古文预训练模型`GuwenBERT`。\n\n对于古文的常见任务：断句，标点，专名标注，目前通常采用序列标注模型。这类模型非常依赖预训练的词向量或者BERT，所以一个好的语言模型可以大幅提高标注效果。经过实验，在古文NER任务中我们的BERT比目前最流行的中文RoBERTa效果**提升6.3%**，仅仅300步就可以达到中文RoBERTa的最终水平，特别适合**标注语料不足的小数据集**。使用我们的模型也可以**减少数据清洗，数据增强，引入字典等繁琐工序**，在评测中我们仅仅用了一个BERT+CRF的模型就可以达到第二名。\n\n* `GuwenBERT`基于`殆知阁古代文献`语料训练，其中包含15,694本古文书籍，字符数1.7B。所有繁体字均经过简体转换处理。\n\n* `GuwenBERT`的词表是基于古文语料构建的，取其中高频字符，大小为23,292。\n\n* 基于继续训练技术（Continue Training），`GuwenBERT`结合现代汉语RoBERTa权重和大量古文语料，将现代汉语的部分语言特征向古代汉语迁移以提升表现。\n\n## 相关项目\n\n* [CCLUE](https://cclue.top): 古文语言理解测评基准\n* [GuwenModels](https://github.com/Ethan-yt/guwen-models): 古文自然语言处理模型合集, 收录互联网上的古文相关模型及资源.\n\n\n## 在线体验\n\n### 古文预训练语言模型\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://huggingface.co/ethanyt/guwenbert-base\"\u003e\n    \u003cimg width=\"601\" alt=\"image\" src=\"https://user-images.githubusercontent.com/9592150/131475589-7b007f0f-3391-4f98-924e-d6dee4178c75.png\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n点击图片或[这里](https://huggingface.co/ethanyt/guwenbert-base)跳转。第一次计算可能需要加载模型，请多等一会。\n\n### 古文自然语言处理流水线\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://cclue.top/guwen-models.html\"\u003e\u003cimg width=\"888\" alt=\"image\" src=\"https://user-images.githubusercontent.com/9592150/131475298-793b9693-bcba-4a2c-8ad2-8036d6171957.png\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n点击图片或[这里](https://cclue.top/guwen-models.html)跳转。\n\n\n## 新闻\n2021/7/25 和下游任务相关的模型、代码已经上传，欢迎star：https://github.com/Ethan-yt/guwen-models\n\n2020/10/31 CCL2020会议分享：基于继续训练的古汉语语言模型 [slides](./assets/基于继续训练的古汉语语言模型.pdf)\n\n2020/10/25 我们的模型已接入[Huggingface Transformers](https://github.com/huggingface/transformers)，查看[使用说明](#使用说明)\n\n2020/9/29 我们的模型获得2020年“古联杯”古籍文献命名实体识别评测大赛 **二等奖** \n\n\n## 使用说明\n### Huggingface Transformers\n\n\n依托于[Huggingface Transformers](https://github.com/huggingface/transformers)，可轻松调用以下模型\n* **`ethanyt/guwenbert-base`**：12-layer, 768-hidden, 12-heads\n* **`ethanyt/guwenbert-large`**：24-layer, 1024-hidden, 16-heads\n\n代码如下\n```python\nfrom transformers import AutoTokenizer, AutoModel\n\ntokenizer = AutoTokenizer.from_pretrained(\"ethanyt/guwenbert-base\")\n\nmodel = AutoModel.from_pretrained(\"ethanyt/guwenbert-base\")\n```\n\nNote: 由于本工作使用中文语料，RoBERTa原作Tokenizer是基于BPE算法的，对中文不太友好，所以这里使用BERT的分词器。这个配置已经写入`config.json`，所以直接使用`AutoTokenizer`会自动加载`BertTokenizer`, `AutoModel`会自动加载`RobertaModel`。\n\n## 模型下载\n\n\u003e 我们提供的模型是PyTorch版本，如果需要tensorflow版本请自行通过[Transformers](https://github.com/huggingface/transformers)提供的转换脚本进行转换。\n\n### 直接下载\n\n通过huggingface官网直接下载：\n\nhttps://huggingface.co/ethanyt/guwenbert-base\n\nhttps://huggingface.co/ethanyt/guwenbert-large\n\n拉到最下方点击\"List all files in model\" → 在弹框中下载每个文件。\n\n### 镜像\n\n\n中国大陆境内用户如果无法直接下载huggingface hub的模型，可以使用以下镜像：\n\n| 模型名称 | 大小 | 百度网盘 |\n| :-----  | :-- | :------ |\n| guwenbert-base | 235.2M | [链接](https://pan.baidu.com/s/1dw_08p7CVsz0jVj4jd58lQ) 提取码: 4jng |\n| guwenbert-large | 738.1M | [链接](https://pan.baidu.com/s/1TL9mBIlIv2rSvp61xCkeJQ) 提取码: m5sz |\n\n\n## 评测结果\n\n### 2020年“古联杯”古籍文献命名实体识别评测大赛-第二名\n\n本评测任务由古联（北京）数字传媒科技有限公司举办。古籍文献的整理和分析对数字人文研究和中华文化传承具有重要意义。命名实体识别在古籍文献处理过程中极为重要，是其他工作得以顺利开展的关键。该项工作会影响到古文自动标点、文白翻译等一系列自动化处理工作，因此，能够从古籍文献中自动识别出专名信息是一项非常重要且有价值的工作。\n\n具体任务为：根据给定的古籍篇章，将候选篇章中的命名实体提取出来，并且按照既定类别进行归并。提取出来的实体名称大致分为两类：书名和其他专名(含人名、地名、朝代名、民族名等)。\n\n数据集方面：分为训练数据和评测数据，涉及经、史、子、集等1900多篇古籍文本。训练数据为带有标签的文本文件，共计1063291字符（计空格），含11068组书名，10040组专名。\n\n| 实体类型    | Precision   | Recall | F1    |\n|:----------:|:-----------:|:------:|:-----:|\n| 书名  | 77.50       | 73.73  | 75.57 |\n| 其他专名 | 85.85       | 89.32  | 87.55 |\n| 平均值 | 83.88       | 85.39  | 84.63 |\n\n\n\n## FAQ\n\n有任何问题可以直接在Issue区留言，或者直接邮件联系我。这里会总结一些常见问题。\n\nQ: **“古联杯”评测数据集可以公开吗？**\n\nA: 和主办方通过邮件询问了一下，主办方表示不能公开，如有需要可以联系zhucuiping@ancientbooks.cn\n\nQ: **预训练时，阶段1和阶段2使用的是相同的语料吗？阶段1训练时是否掺入了现代汉语的语料？**\n\nA: 两个阶段的语料、任务相同，唯一不同的只是第一阶段冻结了Transformer层，以便学习embeddings\n\n## 使用建议\n* 初始学习率是非常重要的一个参数，需要根据目标任务进行调整。\n* 对于需要用到CRF的模型，请将CRF层的学习率调大，一般为RoBERTa的100倍以上\n\n## 预训练过程\n\n\u003e Note: 本节介绍的是预训练的过程，微调不要参考本节配置\n\n模型首先由`hfl/chinese-roberta-wwm-ext`初始化，然后按照以下两步训练：第一步，模型只更新Embedding层；第二步，所有参数共同更新。模型在 4 块 V100 上训练 120K 步(第一步 20K, 第二步 100K)。\n\n\u003cp align=\"center\"\u003e\n    \u003cbr\u003e\n    \u003cimg src=\"./assets/pre-train-work-flow.png\"/\u003e\n    \u003cbr\u003e\n\u003c/p\u003e\n\n详细的超参数设置如下：\n\n| Name | Value |\n|:---------|:----|\n|Batch size |2,048|\n|Seq Length | 512 |\n|Optimizer| Adam |\n|Learning Rate| 2e-4(base), 1e-4 (large) |\n|Adam-eps | 1e-6 |\n|Weight Decay | 0.01|\n|Warmup | 5K steps, linear decay of learning rate after.| \n\n## 引用\n如果本文中的内容对你的研究工作有所帮助，欢迎在论文中引用本工作。由于论文尚未发表，可以暂时以脚注的形式\n\n```tex\n\\footnote{GuwenBERT \\url{https://github.com/ethan-yt/guwenbert}}.\n```\n\n## 免责声明\n报告中所呈现的实验结果仅表明在特定数据集和超参组合下的表现，并不能代表各个模型的本质。\n实验结果可能因随机数种子，计算设备而发生改变。\n**该项目中的内容仅供技术研究参考，不作为任何结论性依据。使用者可以在许可证范围内任意使用该模型，但我们不对因使用该项目内容造成的直接或间接损失负责。**\n\n## 感谢\n\n本工作是基于[中文BERT-wwm](https://github.com/ymcui/Chinese-BERT-wwm/blob/master/README.md)继续训练的。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FEthan-yt%2Fguwenbert","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FEthan-yt%2Fguwenbert","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FEthan-yt%2Fguwenbert/lists"}