🧡 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!
- Fork 项目
- 创建功能分支 (
git checkout -b feature/amazing-feature) - 提交修改 (
git commit -m 'Add amazing feature') - 推送分支 (
git push origin feature/amazing-feature) - 创建 Pull Request
📄 许可证
- GPL-3.0
👤 作者
GraceFox
🙏 致谢
感谢以下工具和服务:
Metadata
Release files for pyamber 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| pyamber-0.2.1.tar.gz | 123.9 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pyamber-0.2.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 313.4 kB
Release files / pyamber-0.2.1.tar.gz
| Download URL | pyamber-0.2.1.tar.gz |
|---|---|
| Size | 123.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8ade2524802402080b5b57674f4f6daa71aea643b42fb60a46c5dea4da92b8db
|
|
BLAKE2b-256 checksum How to use checksums |
31509e31c214dd7ffe701e5a8803c99ab0b193bc63a09fc88b9978c5d0ae985e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.5
|
Release files / pyamber-0.2.1-py3-none-any.whl
| Download URL | pyamber-0.2.1-py3-none-any.whl |
|---|---|
| Size | 189.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
80f9c148e189e765e7aed62614554ffbf52103dca726d38ad4c9ff373ed86841
|
|
BLAKE2b-256 checksum How to use checksums |
6990e5b389f6f8932c4a0aec922997eb14fd5da55ae15210fbbf7253bd5b98c3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.5
|
Security for pyamber 0.2.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.