古典语言工具包（CLTK）是一个 Python 库，为前现代语言提供自然语言处理（NLP）功能。

安装

安装 CLTK 的最新版本：

pip install cltk

可选扩展：

• GenAI（由 OpenAI 提供支持的标注）：

pip install "cltk[openai]"

• Stanza（基于斯坦福 Stanza 的判别式 NLP 后端）：

pip install "cltk[stanza]"

您可以组合使用这些扩展，例如：

pip install "cltk[openai,stanza]"

# 或者同时包含本地 LLM 支持
pip install "cltk[openai,stanza,ollama]"

• 通过 Ollama 使用本地 LLM：

安装可选扩展，并确保本地已运行 Ollama 服务器：

pip install "cltk[ollama]"

默认情况下，当 backend='ollama' 时，CLTK 使用模型 llama3.1:8b。要选择其他本地模型，可以将 model 参数传递给 NLP(...)，例如 qwen2.5:14b、gemma2:27b、llama3.1:70b，或任何 Ollama 模型名称。

选择模型

• OpenAI 后端（云端 GenAI）：

from cltk import NLP

# 默认模型是 "gpt-5-mini"，当 backend='openai' 时
nlp = NLP('lati1261', backend='openai')

# 选择特定模型
nlp_big = NLP('lati1261', backend='openai', model='gpt-5')

# 需要在环境中设置 OPENAI_API_KEY
# （例如通过 .env 文件或 shell 环境变量）

• Ollama 后端（本地 LLM）：

from cltk import NLP

# 默认模型是 "llama3.1:8b"，当 backend='ollama' 时
nlp_local = NLP('lati1261', backend='ollama')

# 选择特定本地模型（任何已安装或可拉取的 Ollama 模型）
nlp_qwen = NLP('lati1261', backend='ollama', model='qwen2.5:14b')

# 若要使用托管的 Ollama Cloud，需设置 OLLAMA_CLOUD_API_KEY
# 并选择 backend='ollama-cloud'。同样适用上述模型名称。

如需更多信息，请参阅 安装文档，或从源代码安装，请参考 开发指南。

1.0 版本之前的软件仍可在 v0.1.x 分支 上找到，相关文档位于 https://legacy.cltk.org。可通过 pip install "cltk<1.0" 进行安装。

文档

文档位于 https://docs.cltk.org。

引用

在使用 CLTK 时，请引用以下出版物，并注明 DOI：

Johnson, Kyle P., Patrick J. Burns, John Stewart, Todd Cook, Clément Besnier, 和 William J. B. Mattingly. “古典语言工具包：面向前现代语言的 NLP 框架。” 载于《第 59 届计算语言学协会年会暨第 11 届国际自然语言处理联合会议：系统演示》，页 20–29。2021 年。10.18653/v1/2021.acl-demo.3

完整的 BibTeX 条目如下：

@inproceedings{johnson-etal-2021-classical,
    title = "The {C}lassical {L}anguage {T}oolkit: {A}n {NLP} Framework for Pre-Modern Languages",
    author = "Johnson, Kyle P.  and
      Burns, Patrick J.  and
      Stewart, John  and
      Cook, Todd  and
      Besnier, Cl{\'e}ment  and
      Mattingly, William J. B.",
    booktitle = "Proceedings of the 59th Annual Meeting of the Association for Computational Linguistics and the 11th International Joint Conference on Natural Language Processing: System Demonstrations",
    month = aug,
    year = "2021",
    address = "Online",
    publisher = "Association for Computational Linguistics",
    url = "https://aclanthology.org/2021.acl-demo.3",
    doi = "10.18653/v1/2021.acl-demo.3",
    pages = "20--29",
    abstract = "本文宣布古典语言工具包（CLTK）1.0 版本的发布，该工具包是一个用于前现代语言的 NLP 框架。目前大多数 NLP 技术及其算法和软件都是基于对现代语言的假设而设计的，因此忽略了大量非口语历史语言的一些重要特性。此外，研究前现代语言的学者通常与研究现代语言的研究者有着不同的目标。为了填补这一空白，CLTK 借鉴了几种领先的 NLP 框架的思想，构建了一种新颖的软件架构，以满足前现代语言及其研究者的独特需求。其核心是一个模块化的处理流程，能够在算法多样性与预设默认值之间取得平衡。CLTK 目前为近 20 种语言提供了包括模型在内的处理流程。"
}

许可证

版权所有 © 2014–至今 Kyle P. Johnson，采用 MIT 许可证。

CLTK 快速上手指南

CLTK（Classical Language Toolkit）是一个专为前现代语言（如拉丁语、古希腊语等）设计的 Python 自然语言处理（NLP）库。

环境准备

• 操作系统：支持 Windows、macOS 和 Linux。
• Python 版本：建议使用 Python 3.8 或更高版本。
• 前置依赖：
  • 若使用 OpenAI 后端，需准备 OPENAI_API_KEY。
  • 若使用本地大模型（Ollama），需先在本地安装并运行 Ollama 服务。

安装步骤

1. 基础安装

安装最新版本的 CLTK：

pip install cltk

国内加速建议：如遇下载缓慢，可使用清华或阿里镜像源：

pip install cltk -i https://pypi.tuna.tsinghua.edu.cn/simple

2. 可选扩展安装

根据需求安装额外功能模块：

• GenAI (OpenAI 云端标注)：

  pip install "cltk[openai]"
  

• Stanza (斯坦福判别式 NLP 后端)：

  pip install "cltk[stanza]"
  

• 本地大模型支持 (Ollama)：

  pip install "cltk[ollama]"
  

• 组合安装示例（同时支持 OpenAI、Stanza 和本地 Ollama）：

  pip install "cltk[openai,stanza,ollama]"
  

基本使用

以下示例展示如何初始化 NLP 管道并选择不同后端模型。代码中的语言代码 'lati1261' 代表拉丁语。

1. 使用 OpenAI 后端（云端）

需确保环境变量中已设置 OPENAI_API_KEY。

from cltk import NLP

# 使用默认模型 (gpt-5-mini)
nlp = NLP('lati1261', backend='openai')

# 指定特定模型
nlp_big = NLP('lati1261', backend='openai', model='gpt-5')

2. 使用 Ollama 后端（本地运行）

需确保本地 Ollama 服务正在运行。默认模型为 llama3.1:8b。

from cltk import NLP

# 使用默认本地模型
nlp_local = NLP('lati1261', backend='ollama')

# 指定其他已安装的本地模型 (如 qwen2.5:14b)
nlp_qwen = NLP('lati1261', backend='ollama', model='qwen2.5:14b')

3. 使用 Ollama Cloud（云端托管）

若使用托管版 Ollama，需设置 OLLAMA_CLOUD_API_KEY 并更改后端名称。

from cltk import NLP

# 连接到 Ollama Cloud
nlp_cloud = NLP('lati1261', backend='ollama-cloud', model='llama3.1:70b')

更多详细文档请访问：https://docs.cltk.org