HIXL（Huawei Xfer Library）是一个灵活、高效的昇腾单边通信库，面向集群场景提供简单、可靠、高效的点对点数据传输能力。
🔥Latest News
- [2026/05] 《HIXL应用开发系列教程》发布，讲解昇腾单边通信库核心概念与应用开发方法。
- [2026/04] HIXL支持Device UBoE，详见[Issue #275]; HIXL跨代际能力增强，支持A2/A3/A5异构 [Issue #138]，[Issue #115]。
- [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 # 测试工程目录
⚡️快速入门
若您希望快速体验该组件的构建和样例执行，请访问如下文档获取简易教程。
📖学习教程
若您希望深入了解组件的相关接口并修改源码，请访问如下文档获取详细教程。
如果希望深入了解 HIXL 开发指南和技术文章等内容，可参考以下文档：
- HIXL 资料书架总览：汇总HIXL相关资料、技术文章和培训视频链接。
🤖 AI Agent支持
- AI辅助编程：介绍仓内默认使用的一些skills及触发方式，用于提升开发者编程效率和代码质量。
- Zread智能问答：本仓已集成 Zread 代码仓智能体，旨在通过 AI 技术为您提供更深度的代码理解与技术支持，开启在线智能代码学习与知识问答体验！
⚠️ 说明： 当前代码AI Agent服务处于试点阶段。在使用过程中，如果您发现 AI 生成的内容存在准确性问题，或对智能助手的功能有任何改进建议，欢迎通过 Issues 与我们交流，您的反馈对我们非常重要！
📝相关信息
🤝联系我们
本项目功能和文档正在持续更新和完善中，欢迎您关注最新版本。
- 问题反馈：通过GitCode【Issues】提交问题。
- 社区互动：通过GitCode【讨论】参与交流。
- 经验分享：通过GitCode【Wiki】分享经验总结。
- 加入交流群：通过扫描下方微信二维码添加HIXL小助手微信，加入微信群与我们进一步交流。
Introduction
HIXL（Huawei Xfer Library）是一个灵活、高效的昇腾单边通信库，面向集群场景提供简单、可靠、高效的点对点数据传输能力。
Customize my domain