
sematic
用纯 Python 构建可复现的 ML 流水线,一键上云
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1003
使用教程
环境要求
- 已安装 Python 3 环境(README 中命令使用 python3 与 pip)
- 已安装 pip 包管理器,可执行 pip install
- 云/集群执行需自备 Kubernetes 集群(可选,详见官方文档)
安装与启动步骤
-
1安装 Sematic
在当前 Python 环境中安装 Sematic 包,README 强调无需任何部署或基础设施即可开始。
pip install sematic -
2启动本地仪表盘
启动本地 Web 仪表盘,用于查看流水线图、实时日志与元数据追踪。
sematic start -
3运行示例流水线
运行官方仓库自带的 MNIST PyTorch 示例,验证本地执行链路是否正常。
sematic run examples/mnist/pytorch -
4创建新项目
生成一个新的样板项目 my_new_project,作为编写自己流水线的起点。
sematic new my_new_project -
5从示例创建项目
以现有 MNIST 示例为模板创建项目,便于快速改造为自己的流水线。
sematic new my_new_project --from examples/mnist/pytorch -
6运行自己项目
以模块方式运行刚创建的项目,在本地仪表盘中观察执行结果。
python3 -m my_new_project
如何确认成功
sematic start 后浏览器打开其提示的本地 Web 仪表盘地址,能看到流水线图与运行日志即成功。
常见问题
Q:需要先搭建集群或部署基础设施吗?
A:不需要。README 明确说明本地入门无需任何部署或基础设施,直接 pip install sematic 即可开始探索。
Q:本地写的代码能直接上云吗?
A:可以,Sematic 具备 local-to-cloud parity,同一份代码可在本地笔记本与 Kubernetes 集群上运行,云端部署见官方文档。
Q:云端部署到 Kubernetes 怎么做?
A:README 未给出具体命令,只指向官方文档 https://docs.sematic.dev,请按该文档操作。
Q:仪表盘能看什么?
A:可查看流水线可视化图、实时日志,以及被持久化追踪的全部流水线产物,便于复现与排错。
注意事项
- README 未给出仪表盘端口、配置文件与环境变量,如遇问题请查阅官方文档 docs.sematic.dev
- 运行 sematic run examples/mnist/pytorch 需要在包含 examples 目录的 Sematic 仓库根目录下执行
- 每个流水线步骤可自定义 CPU、内存、GPU、Spark 集群等资源,用于优化性能与云端成本
核心亮点
- 纯 Python 装饰器定义流水线,学习成本低,上手快
- 自动缓存和依赖管理,避免重复计算,节省成本
- 提供可视化界面和实时日志,调试和监控方便
不足之处
- 项目早期,社区和文档相对有限
- 与成熟平台相比,生态和集成能力待完善
适用场景
- 数据科学团队快速搭建和迭代 ML 实验流水线
- 需要从本地开发无缝迁移到云上执行的场景
- 希望提升 ML 流水线可复现性和可观测性的团队
替代项目
Kubeflow、Flyte、Metaflow
上一篇:fastapi-template
下一篇:soorgeon
同类项目推荐
fragments
开源
用 AI 一句话生成完整 Next.js 应用,快速搭建全栈原型
Open-source Next.js template for building apps that are fully generated by AI. By E2···
chainlit
开源
几分钟内把 LLM 变成可交互的聊天应用
Build Conversational AI in minutes ⚡️
perchance
开源
用 Python 调用 Perchance 生成器,快速实现文本和图像生成。
Unofficial Python API for Perchance.
ai
开源
一套代码,多模型接入,类型安全,前端框架通吃。
Type-safe, provider-agnostic TypeScript AI SDK for streaming chat, tool calling, age···
llm-ui
开源
用 React 快速搭建 LLM 聊天界面,流式输出开箱即用
The React library for LLMs
h5i
开源
本地一键拉起隔离沙箱,让 AI 代理安心跑代码
An Axum-based Rust web framework with Lean 4-verifiable application kernels that run···
LLMstudio
开源
让 LLM 应用从原型到生产,少踩坑、快落地
Framework to bring LLM applications to production
claude-code-workflows
开源
让 Claude Code 干活不跑偏,聚焦你批准的结果。
Development workflows for Claude Code that keep broad exploration focused on the out···
agent-skills
开源
给 AI 编程代理装技能,先审后用更放心
The secure, validated skill registry for professional AI coding agents. Extend Antig···