HanLP

中文分词到语义分析,一套 API 全搞定

开源 🏷️基础免费,高级付费 ⏳ 访问状态待核验 开发框架 🍴 复刻 10874 🐛 待处理 12 👀 关注 1108
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 36532
维护状态 较活跃
是否开源 开源
定价模式 🏷️基础免费,高级付费 支持限时试用 · 开源版免费,云端API按量付费,有免费额度

项目预览

HanLP 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类开发框架
开发团队hankcs
定价模式🏷️基础免费,高级付费
价格说明开源版免费,云端API按量付费,有免费额度
访问状态⏳ 访问状态待核验
是否开源是
开源协议Apache-2.0
主要语言Python
技术栈/模型dependency-parser,hanlp,named-entity-recognition,natural-language-processing,nlp,pos-tagging,semantic-parsing,text-classification
GitHub 星标★ 36532
上线时间2014-10-09 00:00:00
代码更新2026-10-25
仓库体积71.2 MB
本站数据更新2026-11-03
维护状态较活跃
收录时间2026-11-03
浏览次数0

项目介绍

HanLP 是一个面向生产环境的中文自然语言处理工具包,用 Python 编写,提供从基础到高阶的完整 NLP 流水线。它解决的核心问题是:中文文本没有天然词边界,且句法、语义结构复杂,开发者若从零搭建分词、词性标注、命名实体识别、句法依存与语义依存分析、文本分类等能力,成本极高。HanLP 把这些能力封装成统一 API,并配套预训练模型与多任务模型,支持一键加载、批量推理与自定义训练。项目历经多年迭代,文档体系较完整,社区活跃,适合作为中文 NLP 的工程底座。其定位不仅是教学演示,更强调工业可用性,覆盖学术研究与实际业务两条路线,在中文信息处理领域具有较高知名度与引用度。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-11-03 · 当前星标 ★ 36532

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:入门 约 10 分钟 部署方式:库/依赖 4 步

环境要求

  • Python 环境(README 通过 PyPI 分发 hanlp 包,可从 PyPI 安装)
  • 已安装 PyTorch 或 TensorFlow 2.x 深度学习后端(README 说明 HanLP 基于二者构建)
  • 能够正常访问 PyPI 与模型下载源的网络环境
  • 预留足够磁盘空间存放预训练模型

安装与启动步骤

  1. 1安装 hanlp 包

    README 标注了 PyPI 包 hanlp,用 pip 安装即可,建议在独立虚拟环境中执行,避免与已有依赖冲突。

    pip install hanlp
  2. 2导入库并加载模型

    通过 hanlp.load 加载预训练多任务模型,模型标识用 README 中给出的常量,首次加载会下载模型文件。

    import hanlp
    
    HanLP = hanlp.load(hanlp.pretrained.mtl.UD_ONTONOTES_TOK_POS_LEM_FEA_NER_SRL_DEP_SDP_CON_XLMR_BASE)
  3. 3执行多语种推理

    把文本列表直接传给加载好的模型对象即可,一次返回分词、词性、命名实体、依存等多个任务结果。

    print(HanLP(['In 2021, HanLPv2.1 delivers state-of-the-art multilingual NLP techniques to production environments.',
                 '2021年、HanLPv2.1は次世代の最先端多言語NLP技術を本番環境に導入します。',
                 '2021年 HanLPv2.1为生产环境带来次世代最先进的多语种NLP技术。']))
  4. 4按语种换用单语模型

    README 指出处理英、中、日文时各语种单语模型效果明显优于多语种模型,可按需在文档模型列表中挑选替换。

关键配置

配置项必填说明示例
hanlp.pretrained.mtl.UD_ONTONOTES_TOK_PO是README Quick Start 中加载的多语种多任务预训练模型标识hanlp.pretrained.mtl.UD_ONTONOTES_TOK_POS_LEM_FEA_NER_SRL_DE

如何确认成功

运行示例代码后能打印出包含分词、词性、命名实体等多任务字段的结果,即表示模型加载与推理成功。

常见问题

Q:第一次运行很久没输出?

A:首次使用会下载预训练模型,模型体积较大,需等待下载完成;请确认网络与磁盘空间充足后重试。

Q:中英日文本效果不理想怎么办?

A:README 说明 HanLP 为各语种提供单语模型,效果明显优于多语种模型,可在官方文档的模型列表中选用对应单语模型替换。

Q:可以直接把模型当函数调用吗?

A:可以。README 指出 Python 的 HanLPClient 同样遵循可调用语义,可视化与标注规范等细节见官方文档。

注意事项

  • README 未给出具体 Python 版本与 pip 安装命令,安装步骤由 PyPI 徽标推断,建议先建虚拟环境再安装。
  • 首次加载预训练模型会触发下载,耗时与网络、磁盘空间有关。
  • 多语种模型便于统一处理,但生产环境建议按语种选择单语模型。
  • 更多模型列表、可视化与标注说明请查阅官方文档。

核心亮点

  • 覆盖分词、词性、NER、依存句法、语义依存、文本分类等完整中文 NLP 任务链,一个库替代多个零散工具
  • 提供预训练模型与多任务统一模型,加载即用,降低从研究到上线的工程门槛
  • Python 实现且文档较完善,示例丰富,社区活跃,问题响应和版本迭代持续

不足之处

  • 深度模型推理对算力有要求,CPU 环境下大批量处理速度有限
  • 高阶语义任务与最新大模型方案相比,在开放域泛化和少样本场景仍有差距

适用场景

  • 中文文本预处理:分词、词性标注、去停用词,为下游检索或分析打基础
  • 从新闻、评论、工单中抽取人名、地名、机构名等实体,构建结构化信息
  • 对中文句子做依存句法或语义依存分析,支撑关系抽取、知识图谱构建

替代项目

jieba、LTP、spaCy

上一篇:skills

下一篇:generative-ai

同类项目推荐

texar 开源

用 TensorFlow 快速搭建 NLP 和文本生成模型

Toolkit for Machine Learning, Natural Language Processing, and Text Generation, in T···

★ 2393 2026-08-10
loop-engineering 开源

套上现成模板,AI 干活一次比一次稳。

Practical patterns, starters & CLI tools for loop engineering with AI coding agents.···

★ 11681 2026-08-09
nextpy 开源

让AI模型运行时自我进化,告别手动调参

Self-Modifying Framework from the Future World's First AMS

★ 2350 2026-08-09
openai-agents-go 开源

用 Go 快速搭多智能体工作流,接 OpenAI 模型

A lightweight, powerful framework for multi-agent workflows in Go

★ 275 2026-10-13
Awesome-LLM-Prompt-Optimization 开源

一站式速查LLM提示词优化方法,告别手动调参

Awesome-LLM-Prompt-Optimization: a curated list of advanced prompt optimization and ···

★ 420 2026-08-09
burr 开源

用状态机构建可追踪的 AI 决策应用,自托管无忧

Build applications that make decisions (chatbots, agents, simulations, etc...). Moni···

★ 2588 2026-08-09
token-tracker 开源

实时盯紧 AI 编程 token 消耗,省钱又省心

Claude Code & Codex 本地 token 追踪 — 状态栏(Codex 业界首创伪 statusline)、GitHub···

★ 535 2026-08-09