auto-model-monitor 0.1.2

A tool for monitoring model checkpoints and sending notifications

auto_model_monitor

监视模型训练时生成的权重文件，符合条件时发送QQ邮件通知。

使用场景

当你希望在模型训练过程中，当某个指标（例如验证集上的损失或准确率）低于/高于预设阈值时收到邮件通知。这有助于你及时了解模型的性能表现，以便进行必要的调整。

如何使用

安装依赖

pip install auto_model_monitor

获取QQ授权码

为了给QQ邮箱发送邮件，你需要使用授权码而不是密码。你可以在QQ邮箱的设置中找到它。

https://service.mail.qq.com/detail/0/75

示例代码

上述配置后，你就可以使用代码了。

测试代码在tests/test.py

from auto_model_monitor import ModelMonitor, MonitorConfig, CustomParser

# 自定义解析器(TODO: 替换为你的自定义解析器')
parser = CustomParser(pattern=r'val_loss_([0-9.]+)_')

# 配置参数
config = MonitorConfig(
    watch_dir='./quicktest/logs',     # 监控的文件夹路径
    threshold=0.004,                  # 阈值
    sender='[e-mail]',       # 发送邮箱
    receiver='[e-mail]',     # 接收邮箱
    auth_code='xxxx',                 # 邮箱授权码(TODO: 替换为你的授权码')
    check_interval=5,                 # 检查间隔 (秒)
    log_dir='model_monitor_logs',     # 日志文件夹路径
    comparison_mode='lower',          # 比较模式
    parser=parser                     # 使用自定义解析器
)

# 初始化并启动监控器
monitor = ModelMonitor(config)
monitor.start_monitoring()

注意： 你需要修改解析器，以及你自己的邮箱授权码。

当你的模型权重文件中的分数低于或高于阈值时，你将收到邮件通知。例如：

开发日志

2025-07-04 更新：

• 最初版本发布。

2025-07-05 更新：

• 代码重构。如果你需要重构前的代码，在tests/quicktest中查看。
• 代码打包，上传PyPI。
• 由于model_monitor这个名字已经被占用，改为auto_model_monitor。

PyPI库版本

v0.1.0

• 基础版本

v0.1.1

• 代码重构

v0.1.2

• 完善README.md