trainable-agents

微调专属角色扮演大模型,让AI化身历史人物

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 51 🐛 待处理 2 👀 关注 20
GitHub ↗
GitHub 星标 ★ 657
维护状态 低维护
是否开源 开源
定价模式 🏷️完全免费 开源项目,Apache-2.0许可证,可自由使用和部署,无付费版本。

项目预览

trainable-agents 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类开源模型
开发团队choosewhatulike
定价模式🏷️完全免费
价格说明开源项目,Apache-2.0许可证,可自由使用和部署,无付费版本。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言Python
技术栈/模型agent,character,language-model,large-language-models,llm,natural-language-processing,roleplay,sft
GitHub 星标★ 657
上线时间2023-10-08 00:00:00
代码更新2024-10-29
仓库体积18.0 MB
本站数据更新2026-11-11
维护状态低维护
收录时间2026-08-09
浏览次数6

项目介绍

trainable-agents 是论文《Character-LLM: A Trainable Agent for Role-Playing》的官方代码与数据集仓库,旨在构建可训练的角色扮演智能体。它解决了通用大模型在特定角色扮演中缺乏个性、记忆和一致性的问题,通过提供训练代码和数据集,让开发者能够微调语言模型,使其扮演特定历史或虚构人物。核心能力包括:基于角色语料的数据构建、模型微调流程、以及角色对话评估方法。项目使用Python实现,结构清晰,适合研究角色扮演LLM的开发者快速上手。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 657

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:高级 约 120 分钟 部署方式:本地GPU 5 步

环境要求

  • 7B 级基座模型
  • OpenAI 兼容 API
  • GPU 24G 显存

安装与启动步骤

  1. 1拉代码装环境

    依赖较重,先按 README 装好再谈数据生成,别一边装一边调。

  2. 2调 API 生成对话

    它用大模型批量生成角色设定下的对话,prompt_name 决定生成哪类场景。

    python run_api_gen_data.py --prompt_name gen_scene --character Beethoven
  3. 3解析成训练格式

    生成结果是 jsonl,要经过解析器转成监督微调用的样本。

    python parser/parse_data_scene.py result/2023-10-08/gen_scene/gpt-3.5-turbo-temp-0.2-char-Beethoven.jsonl
  4. 4合入基础权重

    最后用 fastchat 的工具把增量权重合回基座,得到可推理的完整模型。

    python3 -m fastchat.model.apply_delta
  5. 5评测角色一致性

    重点看角色设定在多轮里是否走样,这是这类训练的核心指标。

如何确认成功

合成数据能通过解析器,合完权重的模型能稳定保持角色设定至少五轮对话

注意事项

  • 数据靠大模型生成,成本与质量都取决于你选的模型和温度。
  • 生成脚本的日期目录名是写死的,注意别和实际输出路径对不上。
  • 角色扮演模型容易过拟合设定,评测要覆盖设定外的问题。

核心亮点

  • 提供完整的角色扮演LLM训练代码,覆盖数据构建到微调全流程
  • 附带论文配套数据集,可直接用于复现实验
  • 基于主流LLM框架,易于扩展和二次开发

不足之处

  • 文档/社区待观察
  • 项目处于早期,功能相对基础,缺乏高级优化

适用场景

  • 学术研究:复现角色扮演LLM论文实验
  • 游戏开发:训练具有独特人格的NPC对话模型
  • 教育应用:创建历史人物虚拟导师进行互动教学

替代项目

ChatGLM-6B、LlamaFactory、DeepSpeed-Chat

上一篇:app-controller

下一篇:OpenCUA

同类项目推荐

ling-stack 开源

自带模型,本地管好 AI 队友的对话与审批

Local-first AI teammate workspace. Bring your own models and keep project conversati···

★ 980 2026-10-25
turbular 开源

让 AI 一句话查遍所有数据库

A MCP server allowing LLM agents to easily connect and retrieve data from any databa···

★ 98 2026-08-09
Eremos 开源

在Solana上部署智能体集群,抢先捕捉链上早期信号。

Eremos is a lightweight framework for deploying autonomous swarm agents that detect ···

★ 76 2026-08-09
emulo 开源

把聊天日志变成你的 AI 代理专属人设

Mine your Claude Code and Codex logs into a local you.md agent profile.

★ 305 2026-08-09
azure-ai-travel-agents 开源

用多代理框架搭建企业级 AI 旅行助手,一键部署到 Azure

A robust enterprise application sample (deployed on ACA) that leverages MCP and mult···

★ 483 2026-08-10
genspark-claw 开源

一行命令给智能体装上研究、报告、幻灯片等五项实用技能

⚡ Community skill pack & CLI for Genspark Claw, OpenClaw & Hermes agents — 5 produ···

★ 538 2026-09-28
x-twitter-scraper 开源

让 AI 代理轻松读写 X 数据,支持搜索、导出和发布。

X (Twitter) scraper API, MCP server & Claude skill to scrape tweets & followers. Not···

★ 227 2026-08-09
fluent 开源

把想法和反馈自动变成能跑的软件

Fluent is a self-improving software factory. It autonomously turns your team's visio···

★ 125 2026-08-09
eva 开源

一个文件搞定 AI 自动化,命令行直接跑,轻量又省心。

单文件智能体,Single-file zero-dependency AI agent for Linux/Windows ops

★ 431 2026-08-09