# cann-community
**Repository Path**: zjun3021/cann-community
## Basic Information
- **Project Name**: cann-community
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 11
- **Created**: 2025-06-28
- **Last Updated**: 2025-06-28
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# cann-community
欢迎体验CANN开放项目。
## 体验CANN开放项目
- [cann-ops-adv](https://gitee.com/ascend/cann-ops-adv)：融合算子源码仓。
该源码仓当前提供了FlashAttentionScore、FlashAttentionScoreGrad等融合算子的实现源码、设计理念、接口描述文档及调用样例，并提供了工程化的编译、安装、验证能力。
- [ascendc-api-adv](https://gitee.com/ascend/ascendc-api-adv)：Ascend C高阶类库源码仓。
Ascend C高阶类库API是对常见算法的抽象和封装，用于提高算子编程效率。该源码仓提供了数学库、Matmul、Softmax等API的实现源码与高阶API的样例工程，并提供了工程化的编译、安装、验证能力。
- [cann-hccl](https://gitee.com/ascend/cann-hccl)：集合通信库源码仓。
集合通信库（Huawei Collective Communication Library，简称HCCL）是基于昇腾AI处理器的高性能集合通信库，提供单机多卡以及多机多卡间的数据并行、模型并行集合通信方案。该源码仓开放了“通信框架”与“通信算法”两个模块的代码，并提供了工程化的编译安装能力。
- [cann-ops](https://gitee.com/ascend/cann-ops)：基础算子源码仓。
该源码仓是基于昇腾硬件的基础算子库，同时接受外部基础算子贡献。
## 开放项目与CANN版本配套表
开放项目版本号采用 **{标签号}-{匹配的CANN版本号}** 的命名规则，每个开放项目与CANN版本的配套关系详细匹配如下：
## 了解行为准则
在参与贡献前，请了解[CANN开放项目行为准则](contributors/code-of-conduct.md)，后续您在CANN开放项目的活动（包括但不限于发表评论、提交Issue、发表wiki等）都请遵循此行为准则。
## 签署CLA
在参与项目贡献前，您需要签署CANN开放项目贡献者许可协议（CLA）。
请根据您的参与身份，选择签署个人CLA、员工CLA 或企业CLA，请点击[这里](https://clasign.osinfra.cn/sign/gitee_ascend-1720446461942705242)签署。
- 个人CLA：以个人身份参与贡献，请签署个人CLA。
- 企业管理员：以企业管理员的身份参与贡献，请签署企业管理员CLA。
## 参与贡献
在签署了CLA协议、找到了你想参与的开放项目后，就可以开始您的贡献之旅啦！贡献的方式有很多种，每一种贡献都将受到欢迎和重视。
### 提交Issue/处理Issue任务
- 找到Issue列表：
在您感兴趣的CANN开放项目Gitee 主页内，点击“Issues”，即可找到 Issue 列表。
- 提交Issue
如果您准备向社区上报Bug或者提交需求，或者为社区贡献自己的意见或建议，请在CANN开放项目对应的仓库上提交Issue。
提交Issue请参考 [Issue 提交指南](contributors/issue-submit.md)。
- 参与Issue讨论
每个Issue下面都支持开发者们交流讨论，如果您感兴趣，可以在评论区中发表自己的意见。
- 找到愿意处理的Issue
如果您愿意处理其中的一个 issue，可以将它分配给自己。只需要在评论框内输入“/assign”或 “/assign @yourself”，机器人就会将问题分配给您，您的名字将显示在负责人列表里。
### 贡献编码
1. 准备CANN开发环境
如果您想参与编码贡献，需要准备CANN开发环境，请参考每个开放项目的README.md，了解环境准备。
2. 了解CANN开放项目内的开发注意事项
1）每个CANN开放项目使用的编码语言、开发编译环境等都可能存在差异，请参考每个开放项目中的README.md，了解编码贡献的一些要求。
2）CANN开放项目软件编码遵循许可协议：CANN Open Software License Agreement Version 1.0，详细的协议说明请参见每个开放项目中的LICENSE文件，如果您贡献代码到CANN开放项目的源码仓，请遵循此协议。
请在新建的源码文件（包括cpp、py、h等文件）头部增加如下声明：
```
/**
* Copyright (c) 2024 Huawei Technologies Co., Ltd.
* This file is a part of the CANN Open Software.
* Licensed under CANN Open Software License Agreement Version 1.0 (the "License").
* Please refer to the License for details. You may not use this file except in compliance with the License.
* THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
* INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE.
* See LICENSE in the root of the software repository for the full text of the License.
*/
```
3. 代码下载与贡献流程
1. 进行代码开发前，请先将需要参与开发的仓库fork到个人仓，然后将个人仓下载到本地。并在本地分支进行代码修改。
2. 参考每个开放项目的说明文档，进行本地构建与验证。
3. 代码验证满足贡献要求后，提交Pull-Request，将代码贡献到相应的开放项目。
4. 请注意查看门禁测试结果，若未通过，请根据问题提示进行本地代码修改；若通过，此PR会被分配给commiter检视，请关注commiter的检视意见。
5. 当您的PR检视通过后，代码会合入相应的开放项目。
关于Gitee工作流的详细操作可参见[Gitee工作流说明](contributors/gitee-workflow.md)。
当您在提交PR过程中遇到问题，常见问题的解决方法可参见[FAQs](contributors/infra-faqs.md)。
### 参与社区会议
如果您对CANN项目的任意SIG感兴趣，无论您是否熟悉我们的工作，都欢迎通过[项目会议日历](https://meeting-cann.osinfra.cn/calendar)浏览和参与SIG组会议，这是极佳的参与CANN项目的方式
如果您在试用会议系统中遇到了任何问题，欢迎到通过[issue](https://gitee.com/ascend/infrastructure/issues/new)和我们联系
# 加入CANN SIG
SIG 就是 Special Interest Group 的缩写，CANN的开放项目以SIG的形式运作，以便于更好的管理和改善工作流程。SIG 组均是开放的，欢迎任何人来参与。
- SIG都是针对特定的一个或多个技术主题而成立的。SIG的核心成员主导SIG的治理，SIG内的成员推动交付成果输出，并争取让交付成果成为openEuler社区发行的一部分。
- 每一个SIG会拥有一个或多个Repository，SIG的交付成果会保存在这些Repository内。您可以在SIG对应的Repository内提交Issue、针对特定问题参与讨论，提交和解决问题，参与评审等。
|SIG 名称|描述|Repository|
|---|---|---|
|Ops|算子库丰富度和易用性|cann-ops-adv, cann-ops|
|Ascend C| 提高算子开发效率，降低开发者算子开发和模型调优部署的成本|ascendc-api-adv, ascendc-templates|
随着运作深入，将有更多SIG成立，敬请期待。