⚡️更新日志

更新指南

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

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

v0.3.28 - 2024.12.6

🍥公告：硬件监控功能即将推出！

🚀新增功能

• 新增与LightGBM的集成
• 新增与XGBoost的集成

优化

• 提高了对日志记录时单行长度的限制
• 改善了部分性能，为0.4.0版本做准备

v0.3.27 - 2024.11.26

🚀新增功能

• 新增华为昇腾NPU显卡检测
• 新增与青云基石智算(Coreshub)的集成

新UI上线！

🚀我们改进了什么

• 从用户体验出发，上线全新的官网和UI界面
• 上线个人/组织主页
• 增加「黑夜模式」
• 全面优化的「新手快速开始」，增加了框架集成和案例
• 优化「图表对比视图」的实验选择逻辑

v0.3.25 - 2024.11.11

🚀新增功能

• 🎉VSCode插件已上线
• 新增与Keras框架的集成
• 新增run.public方法，支持获取实验的项目名、实验名、链接等信息，#732

v0.3.22 - 2024.10.18

🚀新增功能

• 🎉基线社区Beta版本已上线：https://swanlab.cn/benchmarks
• 新增与PaddleYolo的集成，文档

修复问题

• 修复了在多组并行实验提交时，出现sqlite并行读写报错的问题，#715
• 修复了在CPU品牌记录的兼容性问题

v0.3.21 - 2024.9.26

🚀新增功能

• 组织创建已全面开放，每个组织上限为15人。
• 实验名现已支持「重名」，并使用新的一套新建实验名体系。

v0.3.19 - 2024.9.2

🚀新增功能

• （内测）新增任务式训练swanlab task的网盘存储功能

优化

• 【环境】增加对CPU品牌的记录

问题修复

• 修复了在Win命令行下swanlab login容易出现误操作引发的问题

v0.3.17 - 2024.8.18

1. 完成了对云端图表库以及前端的代码重构，改进了大量交互
2. 修复了实验表格中侧边栏未加载实验没有正常显示参数的问题
3. 修复了requests包引起的部分用户网络连接错误的问题
4. 【环境】增加对NVIDIA驱动版本的记录
5. 本地看版支持对已占用的端口自动续新端口了

v0.3.16 - 2024.7.31

🚀新增功能

• （内测）新增任务式训练swanlab task功能
• 新增与torchtune的集成，文档

优化

• swanlab.init增加参数public，可用于设置创建的新项目的可见性，默认为False
• 用swanlab.init创建的项目默认可见性改为私有
• 新增了swanlab.config对dataclass类型的支持

问题修复

• 修复了在conda-forge环境下import swanlab会提示缺乏依赖库的问题

v0.3.14 - 2024.7.20

问题修复

• 修复环境依赖安装问题
• 修复在Windows系统上存在的一些适配问题

v0.3.13 - 2024.6.27

🚀新增功能

• 新增支持修改实验颜色

⚡️改进

• 优化了在Google CoLab、Jupyter Notebook下的一些问题
• 优化了错误日志收集与打印

问题修复

• 修复了Windows系统下运行的一些问题
• 修复了在Hydra等框架上的终端打印问题
• 修复了了在mmengine集成中SwanlabVisBackend的save_dir不能为None的问题

v0.3.11 - 2024.6.14

🚀新增功能

• 环境记录增加PID和Python Verbose
• 支持修改项目可见性
• 离线看版命令修改为swanlab watch [LOG PATH]

⚡️改进

• 优化了Python环境搜索的性能
• 优化了SwanLab库的架构

问题修复

• 修复了离线看版启动失败的问题

v0.3.10 - 2024.6.10

问题修复

• 修复了部分文本上传时会出现编码错误的问题
• 修复了环境信息没有正确上传的问题

v0.3.9 - 2024.6.8

🚀新增功能

• swanlab logout：支持在终端退出SwanLab账号

👥集成

• 增加与HuggingFace Accelerate的集成，文档

⚡️改进

• 改进了媒体文件上传的稳定性

问题修复

• 修复了nvml库的兼容性问题
• 解决在实验结束时上传大量媒体文件可能引发的409错误
• 修复了在部分机器上会出现OSError的问题

v0.3.8 - 2024.5.31

⚡️改进

• 改进了与ultralytics在ddp场景下的集成
• swanlab.init时增加最新版本的提示

问题修复

• 修复了当log的value为inf会导致线程崩溃的问题
• 修复了训练时间过长时，部分图片上传会失败的问题

v0.3.6 - 2024.5.28

问题修复

• 修复了部分logging日志无法上传的问题
• 修复了swanlab login无法登陆的问题

v0.3.4 - 2024.5.27

🚀新增功能

• swanlab.init增加参数mode，支持新模式disabled
• 支持批量删除实验

⚡️改进

• 优化ultralytics集成代码

👥集成

• 与Stable Baseline3集成，指引

v0.3.3 - 2024.5.22

👥集成

• 与Weights & Biases集成，支持将wandb项目转换为SwanLab项目，指引
• 与Ultralytics集成，指引
• 与fastai集成，指引

v0.3.2 - 2024.5.17

👥集成

• 与Tensorboard集成，支持将Tensorboard日志文件转换为SwanLab实验，指引

🚀新增功能

• 支持下载折线图为PNG图像
• SwanLab实验可以被嵌入到在线文档中了（飞书/Notion等支持嵌入网页的在线文档）
• 表格视图支持导出CSV
• 表格视图支持仅看指标

⚡️改进

• 优化了折线图与表格视图的数值显示

⚙️修复问题

• 修复了在Windows系统下，swanlab.config载入hydra配置文件时，config表格的显示Bug
• 解决SwanLab在jupyter Notebook中的登录问题

v0.3.1 - 2024.5.3

⚡️改进

• swanlog日志文件夹默认增加一个.gitignore

⚙️修复问题

• 修复swanlab.init的config不兼容Omegaconfig等类型的问题