⚡️更新日志

更新指南

升级到最新版：pip install -U swanlab
Github: https://github.com/SwanHubX/SwanLab

v0.7.2 - 2025.11.17

🚀新增功能

• 图表全局设置增加「X轴数据源」
• 图表全局设置增加「悬停模式」，支持设置鼠标Hover某一折线图时，其他图表的悬停模式
• 环境变量新增SWANLAB_WEBHOOK_VALUE

🤔优化

• 修复了一系列问题

v0.7.0 - 2025.11.06

🚀新增功能

• 实验分组上线，支持对大批量实验进行分组管理
• 工作区页面升级，支持快捷在多个组织下切换
• swanlab.init上线group与job_type参数

🤔优化

• 大幅优化了折线图的渲染性能，折线图交互更丝滑

🔧修复

• 修复了一系列已知问题

v0.6.12 - 2025.10.18

🚀新增功能

• 新增Bark通知插件，支持在训练完成/发生错误时，第一时间发送iOS信息通知，文档
• 优化应用性能

v0.6.11 - 2025.10.15

🚀新增功能

• 全新项目UI界面，表格视图支持全局筛选、排序等能力
• 折线图配置新增 X轴数据源 配置功能
• 实验状态新增 ctrl-c，标识用户手动中断的实验
• 新增swanlab local、swanlab online、swanlab offline、swanlab disabled命令，支持在命令行中快速设置SwanLab模式，文档

v0.6.9 - 2025.9.9

🚀新增功能

• 项目支持添加协作者功能，文档
• 组织管理页面大升级，提供更强大的权限控制与项目管理能力
• 新增环境变量SWANLAB_DESCRIPTION、SWANLAB_TAGS、SWANLAB_DISABLE_GIT

🤔优化

• 更强大的图表渲染性能与低侵入式加载动画，让研究者更聚焦于实验分析本身
• 修复了开放API的一些兼容性问题

🔌集成

• 新增与Apple MLX LM框架的集成，文档
• 新增与SGLang SpecForge框架的集成

v0.6.8 - 2025.7.29

🚀新增功能

• 侧边栏支持实验筛选、排序
• 表格视图上线列控制面板，能够方便地实现列的隐藏与显示
• 多API Key管理上线，让你的数据更安全
• swanlab sync 提高了对日志文件完整性的兼容，适配训练崩溃等场景
• 新图表类型-PR曲线、ROC曲线、混淆矩阵上线
• 开放接口新增获取实验指标接口

🤔优化

• 增加 日语、俄语 语言支持
• 实验卡片中的配置表格支持一键折叠/展开
• 修复了一些问题

v0.6.7 - 2025.7.17

🚀新增功能

• 更强大的折线图配置，支持灵活配置线型、颜色、粗细、网格和图例位置
• 支持swanlab.Video数据类型，支持记录与可视化GIF格式文件
• 全局图表仪表盘支持配置Y轴与最大显示实验数
• 更强大的文本图表，适配大语言模型训练场景

🤔优化

• 最大实验名提升到250个字符
• 修复了一些问题

v0.6.5 - 2025.7.5

🚀新增功能

• 支持resume断点续训
• 支持小折线图局部放大
• 支持配置单个折线图平滑

⚙️优化

• 大幅改进了图像图表放大后的交互效果

🔌集成

• 🤗集成accelerate框架，文档增强分布式训练中的实验记录体验；
• 集成ROLL框架，文档增强分布式训练中的实验记录体验；
• 集成Ray框架，文档增强分布式训练中的实验记录体验；

🔌插件

• 新增LogdirFileWriter插件，支持将文件写入到日志文件夹

生态

• 阿里云计算巢服务上架：指引

v0.6.4 - 2025.6.18

🚀新增功能

• 新增与AREAL框架的集成，PR
• 支持鼠标Hover到侧边栏实验时，高亮相应曲线
• 支持跨组对比折线图
• 启用渐进式图表渲染，提高页面加载速度
• 支持设置实验名裁剪规则

⚙️修复

• 修复了local模式下，日志文件无法正确sync和watch的问题

v0.6.3 - 2025.6.12

🚀新增功能

• 新增swnalab.echarts.table，支持创建表格图表
• 昇腾/沐曦/海光/寒武纪/昆仑芯 硬件监控 增加显存（MB）记录
• swanlab sync支持一次多日志上传
• 工作区增加公开/私有筛选
• 表格视图增加最新/最大/最小值切换模块

v0.6.2 - 2025.6.9

🚀新增功能

• 新增swanlab sync命令，支持将本地日志同步到SwanLab云端/私有化部署端
• 支持在本地存储完整的实验日志文件

v0.6.1 - 2025.6.5

🚀新增功能

• 鼠标放到表头，可以显示缩略的名称了
• 表格视图增加「展开子表」功能
• 硬件监控支持海光DCU
• 硬件监控支持获取昇腾NPU的功耗信息

🤔优化

• 优化了HuggigngFace accelerate框架的集成
• 默认不再打印重复step log warning

v0.6.0 - 2025.6.1

🚀新增功能

• 支持 图表自由拖拽
• 支持ECharts自定义图表，增加包括柱状图、饼状图、直方图在内的20+图表类型
• 硬件监控已支持 沐曦 显卡
• 集成 PaddleNLP 框架

v0.5.9 - 2025.5.25

🚀新增功能

• 📒 日志记录支持了标准错误流，EvalScope / PyTorch Lightning等这些框架的日志记录体验大幅提升
• 💻 硬件监控已支持 摩尔线程 显卡
• 🔐 新增运行命令记录的安全防护功能，API Key将被自动隐藏
• ⚙️ 设置新增「默认空间」和「默认可见性」配置，可以指定你的项目默认创建在哪个组织下啦！

v0.5.8 - 2025.5.13

🚀新增功能

• 新增实验Tag功能
• 新增折线图 Log Scale 功能
• 新增 实验分组拖拽 功能
• 新增实验卡片中配置与指标表格下载功能
• 新增开放接口，支持通过API获取SwanLab数据
• 大幅优化了指标传输性能，提升上千指标的传输速度
• 集成paddlenlp框架

🤔优化

• 优化了个人主页的一系列交互

生态

• 腾讯云云应用上架：指引

v0.5.6 - 2025.4.23

🚀新增功能

• 折线图支持图表配置功能，本次更新支持配置图表的X、Y轴范围；主标题；X、Y轴标题
• 图表搜索支持正则表达式
• SwanLab私有化部署版，已支持离线激活验证
• 支持昆仑芯XPU的环境记录与硬件监控
• 适配对使用uv环境下的pip环境记录
• 环境记录支持记录Linux发行版（如Ubuntu、CentOS、Kylin等）

🤔优化

• 修复了侧边栏一键隐藏实验的一些问题

v0.5.5 - 2025.4.7

🚀新增功能

• 新增swanlab.Molecule数据类型，支持生物化学分子可视化，为AlphaFold等AI4Science训练任务提供更好的训练体验
• 实验表格，现在支持记忆你的排序、筛选、列拖拽了！
• 支持了寒武纪MLU的温度和功率指标记录
• 新增SWANLAB_PROJ、SWANLAB_WORKSPACE、SWANLAB_EXP_NAME三个环境变量
• 环境中支持显示寒武纪MLU Logo

🌍生态

• 大模型评估框架EvalScope 已集成SwanLab！：https://github.com/modelscope/evalscope/pull/453

🤔优化

• 优化了网页加载性能

v0.5.4 - 2025.3.31

🚀新增功能

• 新增swanlab.Settings方法，支持更精细化的实验行为控制，进一步增强开放性
• 支持了寒武纪MLU的硬件记录和资源监控
• 昇腾NPU的硬件记录支持记录CANN版本
• 英伟达GPU的硬件记录支持记录GPU架构和cuda核心数
• 英伟达GPU的硬件监控支持记录“GPU 访问内存所花费的时间百分比”
• 「个人主页」支持显示你所在的「组织」
• 「概览」页支持编辑"项目描述"文本

🤔优化

• 修复了sync_wandb的一些问题
• 修复了Obejct3D类的一些问题
• 优化「常规」设置样式
• 大幅优化了打开项目的性能

🔌插件

• 官方插件增加Slack通知、Discord通知，进一步打通海外生态

v0.5.3 - 2025.3.20

🚀新增功能

• SwanLab已正式加入 🤗HuggingFace生态！Transformers 4.50.0版本开始 正式将SwanLab集成为实验跟踪工具，在TrainingArguments中加入report_to="swanlab"即可开始跟踪训练。
• 新增了swanlab.Object3D，支持记录三维点云，文档
• 硬件监控支持了 GPU显存（MB）、磁盘利用率、网络上下行 的记录

优化

• 修复了一些问题

v0.5.0 - 2025.3.12

🎉🎉SwanLab私有化部署（社区版）现已重磅发布！！部署文档

🚀新增功能

• swanlab.init新增参数callbacks，支持在初始化时注册回调函数，以支持各式各样的自定义插件类
• 新增swanlab.register_callback()，支持在init外部注册回调函数，文档
• swanlab.login()升级，新增host、web_host、save参数，适配了私有化部署服务的特性，同时支持不将用户登录凭证写入本地，以适应共用服务器场景。文档
• swanlab login升级，新增host、web_host、api-key参数，文档
• 新增支持使用swanlab.sync_mlflow()将MLFlow项目同步到SwanLab，文档

🤔优化

• 我们大幅优化了sdk架构，提升了sdk在大量metric场景下的性能
• 实验侧边栏可以拉伸了！
• 实验页面右上角增加了「Git代码」按钮，一键跳转到对应的仓库

🔌插件：

• 新增通知类插件，支持在训练结束时使用邮件、飞书、钉钉、企业微信进行通知
• 新增记录类插件，支持在训练过程中将元数据、配置、指标写入到本地CSV文件

v0.4.12 - 2025.3.8

优化

• 修复了一些问题

v0.4.11 - 2025.3.5

优化

• 修复了部分版本W&B格式转换报错的问题
• 修复了一些交互问题

v0.4.10 - 2025.3.4

🚀新增功能

• 新增了和DiffSynth-Studio的集成, 文档
• 新增支持转换 MLFlow 实验到 SwanLab，文档
• 新增项目描述，支持给你的项目记一些简短的笔记

优化

• 修复了在OpenEuler系统上无法正确记录CPU型号的问题

v0.4.9 - 2025.2.28

🚀新增功能

• 新增了移动实验功能
• 对一些集成Callback类增加了update_config方法
• run新增get_url()和get_project_url()方法，支持获取实验和项目的URL

优化

• 修复了在部分Linux系统上CPU品牌获取不到的问题

v0.4.8 - 2025.2.16

🚀新增功能

• 新增了和Modelscope Swift的集成，文档
• 新增了添加分组和移动图表到其他分组功能

优化

• 修复了sdk的一些问题

v0.4.7 - 2025.2.11

🚀新增功能

• swanlab.log支持了参数print_to_console，开启后可以将swanlab.log的key、value以字典的形式打印到终端
• swanlab.init支持了对name、notes参数的适配，等价于experiment_name和description

v0.4.6 - 2025.2.3

🚀新增功能

• 新增与LLM强化学习框架verl的集成，文档
• swanlab.log支持了嵌套字典传入

优化

• 优化了在PyTorch Lightning框架下的分布式训练优化

v0.4.5 - 2025.1.22

🚀新增功能

• 新增swanlab.sync_tensorboardX()和swanlab.sync_tensorboard_torch()：支持使用TensorboardX或PyTorch.utils.tensorboard跟踪实验时，同步指标到SwanLab

优化

• 优化了sync_wandb()的代码兼容性

v0.4.3 - 2025.1.17

🚀新增功能

• 新增swanlab.sync_wandb()：支持使用Weights&Biases跟踪实验时，同步指标到SwanLab，文档
• 新增在使用框架集成时，配置项将记录所使用的框架

优化

• 改进了表格视图的交互，增加了行列拖拽、筛选、排序交互
• 大幅优化了工作区加载的性能
• 大幅优化了日志渲染的性能
• 改进了在未登录的计算机上，执行swanlab.init()的交互
• 修复了一些已知问题

元旦节更新

🚀新增功能

• 升级了图表平滑，网页刷新后状态将仍然保留
• 更新了图表大小修改，现在可以通过拖拽图表的右下角来改变大小

⚙️问题修复

• 修复了没有实验时，项目设置不显示删除的bug

v0.4.2 - 2024.12.24

🚀新增功能

• 新增密码登录
• 新增项目设置页

优化

• 修复在一些设备上运行硬件监控会warning的问题

v0.4.0 - 2024.12.15

🎉万众期待的硬件监控功能（云端版）已经上线，支持CPU、NPU、GPU的系统级信息监控：

• CPU：利用率、线程数
• 内存：利用率、进程利用率、可用内存
• Nvidia GPU：利用率、显存分配、温度、功耗
• Ascend NPU：利用率、HBM分配、温度

更多信息的监控已经在路上！

by Cunyue