cfskit 0.1.2

Common research utilities for our NUIST-GenAI-Lab and CCGM tasks

cfskit

cfskit 是一个科研学术项目脚手架, 初版专注于3个功能点: 日志、实验可视化写入、进程信号控制, 并提供可运行的代码模板:

• nlab-lite-template: 轻量快速实验模板，保留 2-5 分钟快测闭环。
• nlab-template: 论文生命周期模板，面向调研、文档、agent 协作和 OpenClaw 托管实验。

配合这个统一的模板, 可以让所有论文代码复现、二次开发、新建项目在一开始就完成非逻辑性的结构改造，统一成规范标准、结构清晰的实验工程形态。

工具	模块	说明
Logger	cfskit.log_util	基于 loguru 的统一日志，tqdm 兼容，单次初始化
Writer	cfskit.tb_util	基于 TensorBoard 的实验可视化写入，多进程自动适配
IPC	cfskit.ipc_util	基于 SIGUSR1/SIGUSR2 的进程间信号量，支持优雅控制训练流程

基础 API

from cfskit import logger, setup_logger, setup_tensorboard, tb

setup_logger("output/demo/logs", name="nlab")
setup_tensorboard("output/demo/runs", name="nlab")

logger.info("experiment started")
tb.scalar("Loss/train", 0.1, step=1)

安装

pip install cfskit