CANN/hixl昇腾通信库

🔥Latest News

• [2026/03] HIXL已支持超节点内FabricMem模式，详见 FabricMem。
• [2026/01] LLM-DataDist与HIXL已支持下一代芯片的Host RoCE传输能力。
• [2025/12] 基于A3超平面实现D2rH直传；新增链路池与IPv6支持，并对接Mooncake社区的下一代TENT架构。
• [2025/11] HIXL提供异步传输能力，支持更高并发的非阻塞数据传输场景。
• [2025/10] HIXL项目开源，在昇腾芯片上提供高效的多链路D2D/D2H/H2D等单边通信能力，并优化了小数据量批量传输场景的性能。同时HIXL已对接多个开源社区，包含Mooncake，DeepLink等。

🚀概述

HIXL（Huawei Xfer Library）是一个灵活、高效的昇腾单边通信库，面向集群场景提供简单、可靠、高效的点对点数据传输能力，并通过简易API开放给用户, 在多AI应用和多传输链路之间建立了桥梁。可用于构建大模型PD分离、RL后训练参数切换、模型参数缓存等多种业务场景。

核心优势

• 支持单边零拷贝（One-Sided Zero-Copy）通信机制：HIXL提供简易、可靠的单边通信接口，可在本地内存数据准备就绪之后，通过单边操作完成向远端内存的直接数据传输。该机制无需远端节点执行任何操作，为用户构建通信与计算重叠掩盖的调度机制提供核心技术支撑。同时，零拷贝能力实现用户内存间的直接数据传输，避免冗余数据搬运，不仅可以降低内存带宽占用，还可以减少内存容量消耗。
• 屏蔽硬件差异，兼容多链路实现跨设备高速互联：HIXL屏蔽了昇腾系列芯片的底层硬件差异，用户无需针对不同芯片架构进行代码适配。在通信链路层面，该技术原生支持RDMA，HCCS等多种高速互联协议，通信带宽最高可达119GB/s，可实现跨架构设备（如A2系列与A3系列昇腾芯片）的无缝高速互联，满足低时延、 高吞吐的需求。
• 极简API设计，深度适配开源生态框架：HIXL采用极简式API接口设计，接口数量精简至10余个核心调用，降低开发者集成门槛，同时提供完善的C++/Python语言接口支持。目前已实现与Mooncake、DeepLink等开源框架的深度集成，vLLM、SGLang等主流推理引擎也可以直接调用HIXL API完成KV Cache的跨设备高效传输，将大模型推理过程中的内存访问延迟降低20%，显著提升推理吞吐。

核心组件

• HIXL Engine：作为核心传输引擎，提供了基础传输接口，支持多种类型内存类型传输，比如D2D、D2H、H2D。同时兼容多种传输协议，包括HCCS、RDMA等。可实现高速、可靠的数据传输。原生支持多类型数据链路，可灵活同构集群、异构集群的复杂场景。面对集群节点动态扩缩容需求时，可快速完成链路适配与资源调度，为集群整体运行构建可靠通信基础。
• LLM-DataDist：基于HIXL Engine构建，提供了一套携带KV Cache语义的数据传输接口。可快速、灵活对接vLLM、SGLang等推理引擎。

性能表现

在昇腾A3芯片上传输128M数据场景下：

• 通过HCCS链路进行传输，HIXL传输引擎的带宽可达119GB/s
• 通过RDMA链路进行传输，HIXL传输引擎的带宽可达22GB/s

查看基准测试Benchmarks了解更多细节。

🔍目录结构

本项目的关键目录说明如下：

├── build.sh # 项目工程编译脚本 ├── benchmarks # 项目benchmark性能用例 ├── cmake # 项目工程编译目录 ├── CMakeLists.txt # 项目的CMakeList ├── docs # 项目文档介绍 │ ├── cpp # C++文档 │ └── python # Python文档 ├── examples # 端到端样例开发和调用示例 │ ├── cpp # C++样例 │ ├── python # Python样例 ├── include # 头文件 │ ├── hixl │ ├── cs │ ├── adxl │ └── llm_datadist ├── README.md ├── scripts # 脚本路径 │ └── package ├── src # 源码路径 │ ├── hixl │ ├── llm_datadist │ ├── ops │ └── python └── tests # 测试工程目录

⚡️快速入门

若您希望快速体验该组件的构建和样例执行，请访问如下文档获取简易教程。

• 构建：介绍组件的编译和安装，包括编译成功后利用tests进行本地验证。
• 样例执行：介绍如何端到端执行样例代码，包括C++和Python样例。

📖学习教程

若您希望深入了解组件的相关接口并修改源码，请访问如下文档获取详细教程。

• C/C++接口：C++接口介绍。
• Python接口：Python接口介绍。

如果希望深入了解 HIXL 开发指南和技术文章等内容，可参考以下文档：

• HIXL 资料书架总览：汇总HIXL相关资料、技术文章和培训视频链接。

🤖 AI Agent支持

• AI辅助编程：介绍仓内默认使用的一些skills及触发方式，用于提升开发者编程效率和代码质量。
• Zread智能问答：本仓已集成 Zread 代码仓智能体，旨在通过 AI 技术为您提供更深度的代码理解与技术支持，开启在线智能代码学习与知识问答体验！

⚠️ 说明： 当前代码AI Agent服务处于试点阶段。在使用过程中，如果您发现 AI 生成的内容存在准确性问题，或对智能助手的功能有任何改进建议，欢迎通过 Issues 与我们交流，您的反馈对我们非常重要！

📝相关信息

• 贡献指南
• 安全声明
• 许可证
• 所属SIG

🤝联系我们

本项目功能和文档正在持续更新和完善中，欢迎您关注最新版本。

• 问题反馈：通过GitCode【Issues】提交问题。
• 社区互动：通过GitCode【讨论】参与交流。
• 经验分享：通过GitCode【Wiki】分享经验总结。
• 加入交流群：通过扫描下方微信二维码添加HIXL小助手微信，加入微信群与我们进一步交流。

【免费下载链接】hixlHIXL（Huawei Xfer Library）是一个灵活、高效的昇腾单边通信库，面向集群场景提供简单、可靠、高效的点对点数据传输能力。项目地址: https://gitcode.com/cann/hixl