Metadata-Version: 2.4
Name: pyamber
Version: 0.2.1
Summary: 人格工坊 - 让任何人都能用自然语言创造有灵魂、会记忆、能理解、有底线的数字人格
Author-email: GraceFox <948743980@qq.com>
License: GPL-3.0
Project-URL: Homepage, https://github.com/HarePhantom/amber
Project-URL: Documentation, https://github.com/HarePhantom/amber/docs
Project-URL: Repository, https://github.com/HarePhantom/amber
Project-URL: Issues, https://github.com/HarePhantom/amber/issues
Project-URL: Bilibili, https://space.bilibili.com/3706980917054189
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: cryptography>=41.0.0
Requires-Dist: requests>=2.31.0
Provides-Extra: voice
Requires-Dist: edge-tts>=6.0.0; extra == "voice"
Provides-Extra: voice-full
Requires-Dist: amber[voice]; extra == "voice-full"
Requires-Dist: pygame>=2.5.0; extra == "voice-full"
Provides-Extra: api
Requires-Dist: fastapi>=0.100.0; extra == "api"
Requires-Dist: uvicorn>=0.23.0; extra == "api"
Requires-Dist: websockets>=12.0; extra == "api"
Requires-Dist: python-multipart>=0.0.6; extra == "api"
Provides-Extra: security
Requires-Dist: cryptography>=41.0.0; extra == "security"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Provides-Extra: full
Requires-Dist: amber[api,security,voice-full]; extra == "full"
Dynamic: license-file

# 🧡 Amber - 人格工坊

[![Version](https://img.shields.io/badge/Version-0.2.1-green.svg)]()
[![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)]()
[![License](https://img.shields.io/badge/License-GPL3.0-green.svg)]()
[![Bilibili](https://img.shields.io/badge/Bilibili-Amber-ff69b4.svg)](https://space.bilibili.com/3706980917054189)

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

## ✨ 特性

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

### 项目地址
- Github - https://github.com/HarePhantom/amber
- Gitee  - https://github.com/Stehub/amber

## 🚀 快速开始

```bash
# 安装
pip install amber

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

# 运行对话
amber run 浅浅

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

## 📖 文档

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

## 🎤 语音功能

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

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

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

# 列出可用声线
amber voice list

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

## 🎭 角色管理

```bash
# 创建角色
amber role create

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

# 列出已安装角色
amber role list
```

## 📦 依赖

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

## 🎤 语音依赖（可选）

```bash
pip install edge-tts pygame
```

## 📺 视频教程

- [B站主页](https://space.bilibili.com/3706980917054189) - 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 
- 948743980@qq.com
- https://space.bilibili.com/3706980917054189

## 🙏 致谢

感谢以下工具和服务：

- [DeepSeek](https://deepseek.com/) - 提供代码补全、文档撰写和技术支持
- [Edge TTS](https://github.com/rany2/edge-tts) - 语音合成服务
- [pygame](https://www.pygame.org/) - 音频播放支持

