pyamber 0.2.1

人格工坊 - 让任何人都能用自然语言创造有灵魂、会记忆、能理解、有底线的数字人格

🧡 Amber - 人格工坊

让任何人都能用自然语言创造有灵魂、会记忆、能理解、有底线的数字人格。

✨ 特性

• 🎭 四种创建模式 - 快速模式/AI脑补/动态问卷/专家问卷
• 🧠 有情绪 - 会开心、会难过、会记仇、会原谅
• 📝 会记忆 - 记住你说过的话，形成态度
• 🛡️ 有底线 - 话题边界，不可逾越
• 🎤 有声音 - Edge TTS 语音支持（开箱即用）
• 🤝 开源协作 - Fork、改进、PR，像GitHub一样
• 🔒 隐私保护 - 参数层与记忆层分离

项目地址

• Github - https://github.com/HarePhantom/amber
• Gitee - https://github.com/Stehub/amber

🚀 快速开始

# 安装
pip install amber

# 创建人格（快速模式）
amber create "傲娇的高中生" --quick --name 浅浅

# 运行对话
amber run 浅浅

# 启用语音
amber run 浅浅 --voice

📖 文档

文档	说明
安装指南	安装和配置
快速开始	5分钟上手
CLI命令	完整命令参考
人格创建	四种创建模式详解
对话交互	如何与人格对话
语音功能	Edge TTS 语音配置
行为参数	人格行为学习
角色包	角色创建与分享
记忆系统	记忆的工作原理
情绪系统	情绪变化机制
边界系统	话题边界控制
Fork协作	像GitHub一样协作
版权保护	签名、水印、防盗版
Web界面	图形化问卷
API参考	编程接口
常见问题	FAQ
更新日志	版本历史
开发者指南	开发细节

🎤 语音功能

Amber 内置 Edge TTS 支持，开箱即用：

# 启用语音
amber run 林夏 --voice

# 指定声线
amber run 林夏 --voice --voice-id zh-CN-XiaoyiNeural

# 列出可用声线
amber voice list

# 测试语音
amber voice test --text "你好"

🎭 角色管理

# 创建角色
amber role create

# 安装角色包
amber role install ./角色包/

# 列出已安装角色
amber role list

📦 依赖

• Python 3.10+
• click>=8.0.0
• numpy>=1.24.0
• pyyaml>=6.0

🎤 语音依赖（可选）

pip install edge-tts pygame

📺 视频教程

• B站主页 - Amber 使用教程和演示视频

🤝 贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 项目
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 提交修改 (git commit -m 'Add amazing feature')
4. 推送分支 (git push origin feature/amazing-feature)
5. 创建 Pull Request

📄 许可证

• GPL-3.0

👤 作者

GraceFox

• [e-mail]
• https://space.bilibili.com/3706980917054189

🙏 致谢

感谢以下工具和服务：

• DeepSeek - 提供代码补全、文档撰写和技术支持
• Edge TTS - 语音合成服务
• pygame - 音频播放支持