Skip to content

About

Self-evolving humanizer agent with online policy updates and dual-agent critique.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

humanizer-self-evolution

一个可本地运行的 自进化 humanizer agent:把长英文按语义切块,生成多种风格候选句,接收用户选择与反馈,并通过在线权重更新持续改进输出。

当前发布流程默认面向 macOS + Apple Silicon,请先在本机安装 mlxcel-server,再按下方步骤初始化。

亮点

  • 自进化闭环:用户选择/反馈 -> 在线样本 -> 快慢轨训练 -> 8082 热切换新权重
  • 双层输出防护:本地 TinyLlama 生成 + DeepSeek 语义校对,减少无关信息和提示词污染
  • 前端可见:Styled 与 Fallback 卡片有不同背景色,结果来源一眼可见
  • 本地优先:FastAPI + Next.js + mlxcel-server,适合 Apple Silicon 本机运行

你会下载到什么

  • 完整前后端源码
  • 训练 / 评测 / 自进化脚本
  • 安全的 .env.example
  • 空的 data/ 目录占位

仓库 不包含:

  • .env、API key、本地数据库、日志
  • 上传过的源文档、训练集、评测结果
  • 基座模型权重
  • 本地工作区私有文件

快速开始

1. 克隆仓库

git clone https://github.com/kevin0818-lxd/humanizer-self-evolution.git
cd humanizer-self-evolution

2. 安装 mlxcel-server

确认以下命令可用:

mlxcel-server --help

如果你的二进制不在默认 PATH,也可以稍后在 .env 里设置:

MLXCEL_SERVER_BIN=/absolute/path/to/mlxcel-server

3. 下载两个模型资产

基座模型

huggingface-cli download TinyLlama/TinyLlama-1.1B-Chat-v1.0 \
  --local-dir data/models/tinyllama-1.1b-chat-v1.0

当前公开 adapter

从本仓库的 GitHub Releases 下载最新 asset:

  • humanizer-self-evolution-adapter-online-policy-v2-20260805.zip

4. 一键初始化

./scripts/setup_public.sh --adapter-zip /path/to/humanizer-self-evolution-adapter-online-policy-v2-20260805.zip

这个脚本会:

  • 创建运行目录
  • 复制 .env.example 为 .env
  • 解压 Release 里的 adapter 到 data/models/tinyllama-1.1b-online-policy-v2-20260805
  • 安装后端与前端依赖

5. 一键启动

./scripts/start_public.sh

启动后默认会拉起:

  • 8081:质询者 / critic
  • 8082:当前在线权重代理
  • 8083:生成实例
  • 8000:FastAPI
  • 3000:Next.js

打开:

配置说明

默认配置已经能跑起来,通常只需要改一项:

DEEPSEEK_API_KEY=
  • 留空:系统仍可运行,但不会启用 DeepSeek 语义校对层
  • 填入有效 key:会额外清洗无关信息、提示词回显和闲聊开场

如需固定 8081 的 critic 权重,可以在 .env 中设置:

CRITIC_ADAPTER_PATH=/path/to/another/adapter

留空时,启动脚本默认复用当前公开 adapter。

如何看见“自进化”效果

前端里最直观的三个信号:

  1. 卡片颜色:Styled 是青绿色,Fallback 是琥珀色虚线
  2. 生成模式徽章:悬停可看到完整 generation_mode
  3. 重复生成后的变化:随着反馈积累,Fallback 变少、Styled 变多、语义污染减少

常用命令

# 仅初始化环境,不安装依赖
./scripts/setup_public.sh --adapter-zip /path/to/adapter.zip --skip-install

# 自动下载基座模型(需要 huggingface-cli)
./scripts/setup_public.sh --download-base-model --adapter-zip /path/to/adapter.zip

Release 说明

代码仓库只放源码;当前可运行 adapter 放在 Release。

建议发布物至少包含:

  • humanizer-self-evolution-adapter-online-policy-v2-20260805.zip

zip 内建议保留以下文件:

  • adapter_model.safetensors
  • adapter_config.json
  • training_manifest.json
  • tokenizer.json
  • tokenizer.model
  • tokenizer_config.json
  • special_tokens_map.json
  • chat_template.jinja

许可

本项目沿用仓库内的 LICENSE。

About

Self-evolving humanizer agent with online policy updates and dual-agent critique.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages