Skip to main content

🧡 Amber - 人格工坊

Version Python License Bilibili

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

✨ 特性

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

项目地址

🚀 快速开始

# 安装
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

📺 视频教程

🤝 贡献

欢迎提交 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

🙏 致谢

感谢以下工具和服务:

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

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)

Source distribution for pyamber 0.2.1
File Size Uploaded Provenance
pyamber-0.2.1.tar.gz 123.9 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for pyamber 0.2.1
File Interpreter ABI Platform
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page