TinyTroupe

让一群虚拟用户先替你把产品和创意试一遍

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 689 🐛 待处理 35 👀 关注 75

GitHub ↗

GitHub 星标 ★ 7615

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，采用MIT许可证，免费使用

项目预览

项目数据

分类智能体

开发团队microsoft

GitHubhttps://github.com/microsoft/TinyTroupe

定价模式🏷️完全免费

价格说明开源项目，采用MIT许可证，免费使用

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Jupyter Notebook

GitHub 星标★ 7615

上线时间2024-03-25 00:00:00

代码更新2026-10-23

仓库体积104.5 MB

本站数据更新2026-10-24

维护状态活跃

收录时间2026-10-24

浏览次数0

项目介绍

TinyTroupe 是微软开源的多智能体人物模拟框架，用大语言模型驱动一批具有独立性格、目标与记忆的虚拟人物（TinyPerson），在设定好的场景中自主互动，从而帮助团队在真实调研之前先做低成本的推理想象与商业洞察验证。它解决的是传统用户研究、市场测试和创意评估周期长、成本高、样本有限的问题：你可以先构造若干典型用户画像，让它们在模拟环境里讨论产品、评价广告、参与头脑风暴，观察观点如何碰撞与演化。核心能力包括人物定义（性格、偏好、背景）、场景与环境编排、多轮对话与行为推演、结果提取与结构化分析，并支持把模拟过程导出为可复用的报告。项目以 Jupyter Notebook 为主要形态，便于边写边看、快速试验，适合产品经理、市场研究人员和创意团队做早期假设探索，而非替代真实用户数据。

Star 增长趋势

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

数据来源：GitHub API 逐日快照 · 收录于 2026-10-24 · 当前星标 ★ 7615

使用教程

难度：入门约 15 分钟部署方式：库/依赖 6 步

环境要求

已安装 Conda（也可使用其他 Python 发行版，README 以 Conda 为例）
Python 3.10
可用的 OpenAI 或 Azure OpenAI API 密钥
Git（用于克隆仓库，或让 pip 从 git 地址安装）

安装与启动步骤

1创建 Python 环境

用 Conda 新建 Python 3.10 环境，避免与系统已有包冲突。
```
conda create -n tinytroupe python=3.10
```
2激活环境

进入刚创建的环境，后续安装和运行都在此环境内进行。
```
conda activate tinytroupe
```
3配置模型密钥

按 README 的 Pre-requisites 说明，将 OpenAI 或 Azure OpenAI 密钥写入环境变量。
```
export OPENAI_API_KEY=sk-xxxxxxxx
```
4从仓库安装库

官方推荐直接从 GitHub 仓库安装，而不是从 PyPI 安装。
```
pip install git+https://github.com/microsoft/TinyTroupe.git@main
```
5克隆示例仓库

要运行示例需把仓库下载到本地，示例位于 examples/ 目录。
```
git clone https://github.com/microsoft/tinytroupe
cd tinytroupe
```
6启动 Notebook

启动 Jupyter，在浏览器界面进入 examples/ 目录打开示例笔记本。
```
jupyter notebook
```

关键配置

配置项	必填	说明	示例
`OpenAI / Azure OpenAI 密钥环境变量`	是	供调用大语言模型使用，README 要求以环境变量方式设置	`OPENAI_API_KEY=sk-xxxxxxxx`
`action_generator_enable_quality_checks`	否	是否启用动作生成的质量检查	`True`
`action_generator_quality_threshold`	否	动作生成质量检查的阈值	`6`
`cache_api_calls`	否	是否缓存 API 调用结果，减少重复请求	`True`