github.com/SwanHubX/SwanLab @v0.8.4 sqlite

An Professional, Modern-Designed AI Training Analysis Platform
For Model Training Teams, Integrated with 50+ Leading AI Training Frameworks, Easily Combined with Your Experimental Code

🔥SwanLab Online · 📃 Documentation · Report Issues · Feedback · Changelog · SKILL

[![][release-shield]][release-link] [![][dockerhub-shield]][dockerhub-link] [![][github-stars-shield]][github-stars-link] [![][github-issues-shield]][github-issues-shield-link] [![][github-contributors-shield]][github-contributors-link] [![][license-shield]][license-shield-link]
[![][tracking-swanlab-shield]][tracking-swanlab-shield-link] [![][last-commit-shield]][last-commit-shield-link] [![][pypi-version-shield]][pypi-version-shield-link] [![][wechat-shield]][wechat-shield-link] [![][pypi-downloads-shield]][pypi-downloads-shield-link] [![][colab-shield]][colab-shield-link]

中文 / English / 日本語 / Русский

👋 Join our WeChat Group

Table of Contents

• 🌟 Recent Updates
• 👋🏻 What is SwanLab
• 📃 Online Demo
• 🏁 Quick Start
• 💻 Self-Hosting
• 🔥 Tutorials
• 🚗 Framework Integration
• 🔌 Plugins
• 🎮 Hardware Monitoring
• 🆚 Comparison with Familiar Tools
• 👥 Community
• 📃 License

🌟 Recent Updates

• 2026.06.16: 📊 Added HTML charts, supporting pages embedded after LLM Vibe Coding; the Kubernetes deployment Prometheus log monitoring solution is now available;

• 2026.06.05: ⚡️ The refactored SDK (v0.8.0) is now available, significantly improving metric logging performance for large-scale training; SwanLab CLI and Skill are now available for the AutoResearch paradigm;

• 2026.05.18: 📒 Logs now support global filtering, so you can quickly find the log snippets you need across the entire workspace; added chart copy feature; chart search now includes search history; chart details now show relative time;

• 2026.04.28: 🪨 Project Pinning is now live — place the projects your team cares about most in the most prominent spot; improved the metric panel display when hovering over line charts;

• 2026.03.25: 📊 Experiment Pinning is now live — pin your best experiments to the most accessible position with one click; Baseline comparison is now available, supporting comparison of experiments against a baseline with percentage difference display, accelerating the search for optimal parameters;

https://github.com/user-attachments/assets/964380e0-feb2-480d-b1ca-eba1be239ebb

• 2026.03.19: 📊 Added experiment duplication feature, supporting the creation of experiment copies to different projects and teams; parallel mode is now available, supporting multiple processes recording metrics to the same experiment at the same time; experiment ID can now be customized;

• 2026.02.06: 🔥swanlab.Api is now available, providing a more powerful, object-oriented open API interface, documentation; ECharts.Table supports CSV download; now supports one-click placement of charts at the top of sections;

Full Changelog

• 2026.01.28: ⚡️ LightningBoard V2 is now available, significantly improving dashboard performance;

• 2026.01.16: ⚡️ LightningBoard (Lightning Dashboard) V1 is now available, designed for extremely large chart number scenarios; added chart embedding link, now you can embed your charts into online documents (such as Notion, Lark, etc.);

• 2026.01.02: 🥳 Added support for AMD ROCm and Iluvatar GPU hardware monitoring; SDK added heartbeat package feature, implementing more robust cloud/offline connection;

• 2025.12.15: 🎉 Kubernetes Version of SwanLab is now available! Deployment Documentation; NVIDIA NeMo RL framework is now integrated with SwanLab, documentation;

• 2025.12.01: 🕰 Added detailed line chart information display, when hovering over the line chart, clicking Shift will activate Detailed Mode, allowing the display of the log point time; 📊 Chart grouping supports MIN/MAX area range display;

• 2025.11.17: 📊 Global chart configuration now supports X-axis data source selection and hover mode functionality, enhancing chart analysis experience; added SWANLAB_WEBHOOK functionality, documentation

• 2025.11.06: 🔪 Experiment Grouping is live — supports grouping management for large batches of experiments; Workspace page upgraded to allow quick switching between multiple organizations; significantly improved line-chart rendering performance; swanlab.init now supports group and job_type parameters;

• 2025.10.15: 📊 Line chart configuration now supports X-axis data source selection; sidebar now supports displaying pinned columns in table view, enhancing experiment data alignment capabilities;

• 2025.09.22: 📊 New UI launched; table view now supports global sorting and filtering; unified data level for table view and chart view.

• 2025.09.12: 🔢 Added support for scalar chart, flexibly displaying the statistical values of experiment indicators; organization management page has been upgraded, providing more powerful permission control and project management capabilities;

• 2025.08.19: 🤔 Optimized chart rendering performance, allowing researchers to focus more on experiment analysis; integrated excellent MLX-LM and SpecForge frameworks, providing more training scenarios;

• 2025.08.06: 👥 Training Collaboration is now available, supporting inviting project collaborators, sharing project links and QR codes; the workspace now supports list view, and project Tags are now displayed;

• 2025.07.29: 🚀 Added support for experiment filtering and sorting in the sidebar; 📊 Added column control panel to the table view, allowing easy hiding and displaying of columns; 🔐 Added support for managing multiple API Keys, making your data more secure; swanlab sync now supports training crash log files; PR curve, ROC curve, confusion matrix are now available, documentation;

• 2025.07.17: 📊 Added support for line chart configuration, supporting flexible configuration of line type, color, thickness, grid, legend position, etc.; 📹 Added support for swanlab.Video data type, supporting recording and visualizing GIF format files; Global chart dashboard now supports configuring Y-axis and maximum number of experiments displayed.

• 2025.07.10: 📚 Added support for text view, supporting Markdown rendering and direction key switching, which can be created by swanlab.echarts.table and swanlab.Text, Demo

• 2025.07.06: 🚄 Added support for resume training; new plugin File Logger; integrated ray framework, documentation; integrated ROLL framework, thanks to @PanAndy, documentation

• 2025.06.27: Added support for small line chart zooming; added support for configuring single line chart smoothing; significantly improved the interaction effect of image charts after zooming.

• 2025.06.20: 🤗 Integrated the accelerate framework, PR, documentation, enhancing the experience of recording and analyzing experiments in distributed training.

• 2025.06.18: 🐜 Integrated the AREAL framework, thanks to @xichengpro, PR, documentation; 🖱 Added support for highlighting corresponding curves when hovering the mouse over sidebar experiments; Added support for cross-group comparison line charts; Added support for setting experiment name trimming rules;

• 2025.06.11: 📊 Added support for swanlab.echarts.table data type, supporting pure text chart display; added support for stretch interaction for groups, allowing more charts to be displayed at the same time; added maximum/minimum value options for table views;

• 2025.06.08: ♻️ Added support for storing complete experiment log files locally and uploading them to the cloud/private deployment via swanlab sync; Hardware monitoring now supports Hygon DCU;

• 2025.06.01: 🏸 Added support for chart free dragging; added support for ECharts custom chart; added support for PaddleNLP framework; hardware monitoring supports MetaX GPU;

• 2025.05.25: Logging now supports capturing the standard error stream, allowing better recording of output from frameworks like PyTorch Lightning; hardware monitoring now includes support for Moore Threads; added a security feature for logging runtime commands, where API Keys will be automatically hidden.

• 2025.05.14: Added support for experiment tags; added support for Log Scale for line charts; added support for group dragging; significantly optimized the experience of uploading a large number of metrics.

• 2025.05.09: Added support for line chart creation; enhanced the chart configuration feature with data source selection, enabling a single chart to display different metrics; introduced the ability to generate GitHub badges for training projects.

• 2025.04.23: Added support for editing line charts, allowing free configuration of X and Y axis data ranges and title styles; chart search now supports regular expressions; added hardware detection and monitoring for Kunlun Core XPU.

• 2025.04.11: Added support for local selection for line charts; supports the step range of the current graph.

• 2025.04.08: Added support for the swanlab.Molecule data type, enabling recording and visualization of biochemical molecular data; also supports saving the state of sorting, filtering, and column order changes in table views.

• 2025.04.07: We completed joint integration with EvalScope. Now you can use SwanLab in EvalScope to evaluate LLM performance.

• 2025.03.30: Added support for the swanlab.Settings method, enabling more precise control over experiment behavior; added support for Cambricon MLU hardware monitoring; integrated Slack notifications and Discord notifications.

• 2025.03.21: 🎉🤗 HuggingFace Transformers has officially integrated SwanLab (version >=4.50.0), #36433; Added Object3D chart support, now you can track and visualize 3D point clouds, docs; Hardware monitoring supports the recording of GPU memory (MB), disk utilization, and network sent and received.

• 2025.03.12: 🎉🎉 The Privatized Deployment Edition of SwanLab is now available!! 🔗 Deployment Documentation; SwanLab now supports plugin extensions, such as Email Notification and Lark Notification.

• 2025.03.09: Added experiment sidebar width support; added external Git code button; added sync_mlflow feature, supporting synchronization with mlflow framework.

• 2025.03.06: We completed integration with DiffSynth Studio. Now you can use SwanLab in DiffSynth Studio to track and visualize Diffusion model text-to-image/video experiments. Usage Guide

• 2025.03.04: Added MLFlow feature, supporting conversion of MLFlow experiments to SwanLab experiments. Usage Guide

• 2025.03.01: Added move experiment feature, now you can move experiments to different projects in different organizations.

• 2025.02.24: We completed integration with EasyR1. Now you