项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2317
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Python 环境(可通过 pip 安装第三方包)
- 可访问 PyPI 的网络
- 如使用 C++ 版本,需具备 C++ 编译环境(跨平台:Windows/Linux/macOS,无第三方依赖)
安装与启动步骤
-
1安装 PyCGraph
CGraph 提供官方 Python 绑定 pycgraph,直接用 pip 从 PyPI 安装,无需编译 C++ 源码。
pip install pycgraph -
2编写示例脚本
新建 demo.py,定义继承 GNode 的节点类并实现 run 方法,用 GPipeline 注册节点和依赖关系。
-
3运行流水线
执行脚本,框架会按注册的依赖关系自动排序并执行各节点。
python demo.py -
4(可选)克隆源码
如需查看 C++ 源码或用 CMake 构建原生版本,可先克隆仓库到本地。
git clone https://github.com/ChunelFeng/CGraph.git
如何确认成功
终端依次打印带时间戳的 nodeA、nodeB、nodeC、nodeD 日志,其中 nodeD 一定在 nodeB 和 nodeC 之后输出,说明依赖与并行调度生效。
常见问题
Q:必须自己编译 C++ 代码吗?
A:不需要。直接用 pip install pycgraph 安装 Python 绑定即可使用;只有使用原生 C++ 接口时才需要自行构建仓库源码。
Q:运行提示找不到 pycgraph 模块?
A:确认 pip 与运行脚本使用的是同一个 Python 环境(如虚拟环境需先激活),并检查安装是否成功。
Q:节点执行顺序能自己控制吗?
A:可以。顺序由 registerGElement 时传入的前驱节点集合决定,例如 nodeD 依赖 {b, c},就会等两者都完成后再执行。
注意事项
- README 中 registerGElement 的第三个参数为节点名(如 "nodeA"),用于日志中标识节点。
- run 方法返回 CStatus() 表示执行成功,实际使用时可在其中编写自己的业务逻辑。
- 同一层无依赖的节点(如 nodeB 与 nodeC)会被并行调度执行。
核心亮点
- 零第三方依赖,跨平台,编译和部署简单
- 基于 DAG 的调度模型,天然支持并行和依赖管理
- 提供 Python 绑定,兼顾 C++ 性能和 Python 易用性
不足之处
- 文档/社区待观察
- 相比成熟框架,生态和周边工具较少
适用场景
- AI 推理流水线编排,如多模型串联和并行推理
- 数据处理管道,如 ETL 任务依赖调度
- 高性能计算中的任务图并行执行
替代项目
Taskflow、TBB (Threading Building Blocks)、DAGGER
同类项目推荐
ollama-js
开源
在 JS 里一行代码调用本地大模型
Ollama JavaScript library
switch
开源
把任务拆成小步选择,让模型一步步做决定
A framework for building decision-model harnesses for any kind of task. Your program···
flytekit
开源
用 Python 装饰器快速构建可扩展的机器学习工作流
Extensible Python SDK for developing Flyte tasks and workflows. Simple to get starte···
ai
开源
一套代码接入多家大模型,快速构建 AI 应用和智能体
The AI Toolkit for TypeScript. From the creators of Next.js, the AI SDK is a free op···
llm4s
开源
用 Scala 类型安全地搭建 LLM Agent 工作流
Agentic and LLM Programming in Scala
apm
开源
像 npm 一样管理你的 AI 智能体技能包,即装即用。
Agent Package Manager
skillware
开源
像管理软件包一样管理 AI 技能,让智能体能力随需组合。
A Python framework for modular, self-contained skill management for machines.
agent-skills
开源
给 AI 编程代理装技能,先审后用更放心
The secure, validated skill registry for professional AI coding agents. Extend Antig···
pi-less-yolo
开源
在Docker沙箱里安全跑AI编程代理,减少翻车风险
Slightly less YOLO version of pi-coding-agent in Docker container sandbox
