TinyTroupe

TinyTroupe

TinyTroupe is a Microsoft Research library for simulating realistic human personas powered by LLMs. Use it to run synthetic focus groups, user interviews, A/B scenario tests, and brainstorming sessions without recruiting real participants.

Key Features

• TinyPerson — each simulated agent has a detailed persona (age, occupation, beliefs, interests, personality traits)
• TinyWorld — shared environment where multiple agents interact, debate, and respond to stimuli
• Broadcast & listen — send messages to a group; agents form independent opinions and reply in character
• Configurable LLM backend — works with Azure OpenAI, OpenAI, or any OpenAI-compatible API
• Extraction utilities — pull structured data (sentiments, ratings, decisions) from agent conversations
• Use cases — product feedback, ad copy testing, debate simulation, synthetic training data

Quick Start

pip install tinytroupe

from tinytroupe.agent import TinyPerson
from tinytroupe.environment import TinyWorld

alice = TinyPerson("Alice", occupation="software engineer", age=32)
bob = TinyPerson("Bob", occupation="product manager", age=45)

world = TinyWorld("Product Review", [alice, bob])
world.broadcast("What do you think of adding a dark mode to our app?")
world.run(2)  # run 2 rounds of interaction

Install via ai-supply

npx ai-supply add microsoft-tinytroupe-persona-sim

Curated mirror of the open-source TinyTroupe (MIT). Get it from the source.