How microsoft/tinytroupe works
TinyTroupe is a Python library for LLM-powered multiagent persona simulation. Experimenters create or configure personas, place agents in simulated worlds, and observe interactions to investigate human behavior and business questions; outputs can then be extracted and simulations validated. The graph includes the documented experimentation, steering, enrichment, tools, and notebook capabilities. Evidence is limited to the supplied README and source index/excerpts; links for unsampled modules are included only where the index or README supports them.
Main entry points: tiny_person.py Simulated Person · tiny_world.py Simulation World · __init__.py Model Client Registry · tiny_tool.py Agent Tools
Components 32
Persona Simulation
- Persona Factory
tinytroupe/factory/tiny_person_factory.py - Factory Core
tinytroupe/factory/tiny_factory.py - Simulated Person
tinytroupe/agent/tiny_person.py - Simulation World
tinytroupe/environment/tiny_world.py - Social Network
tinytroupe/environment/tiny_social_network.py - Simulation Control
tinytroupe/control.py
Models and Cognition
- Action Generation
tinytroupe/agent/action_generator.py - Agent Memory
tinytroupe/agent/memory.py - Mental Faculties
tinytroupe/agent/mental_faculty.py - Web Grounding
tinytroupe/agent/grounding.py - LLM Chat
tinytroupe/utils/llm.py - Model Client Registry
tinytroupe/clients/__init__.py - OpenAI Client
tinytroupe/clients/openai_client.py - Azure Client
tinytroupe/clients/azure_client.py - Ollama Client
tinytroupe/clients/ollama_client.py
Experimentation and Analysis
- Experiment Runner
tinytroupe/experimentation/in_place_experiment_runner.py - Propositions
tinytroupe/experimentation/proposition.py - Statistical Tests
tinytroupe/experimentation/statistical_tests.py - Empirical Validation
tinytroupe/validation/simulation_validator.py - Results Extraction
tinytroupe/extraction/results_extractor.py - Result Normalization
tinytroupe/extraction/normalizer.py - Results Reporting
tinytroupe/extraction/results_reporter.py - Artifact Export
tinytroupe/extraction/artifact_exporter.py - Interventions
tinytroupe/steering/intervention.py - Simulation Stories
tinytroupe/steering/tiny_story.py
Extensions and Interfaces
- Persona Enrichment
tinytroupe/enrichment/tiny_enricher.py - Persona Styling
tinytroupe/enrichment/tiny_styler.py - Agent Tools
tinytroupe/tools/tiny_tool.py - Calendar Tool
tinytroupe/tools/tiny_calendar.py - Word Processor
tinytroupe/tools/tiny_word_processor.py - Jupyter Interaction
tinytroupe/ui/jupyter_widgets.py
Other components
- Experimenter
Connections 32
- Experimenter → Persona Factory: creates personas
README.md - Experimenter → Simulation World: configures simulation
README.md - Persona Factory → Simulated Person: generates agents
tinytroupe/factory/tiny_person_factory.py - Factory Core → Persona Factory: supports generation
tinytroupe/factory/tiny_factory.py - Simulated Person → Action Generation: generates actions
tinytroupe/agent/tiny_person.py - Simulated Person → Agent Memory: uses memory
tinytroupe/agent/tiny_person.py - Simulated Person → Mental Faculties: uses faculties
tinytroupe/agent/tiny_person.py - Mental Faculties → Web Grounding: uses grounding
tinytroupe/agent/mental_faculty.py - Action Generation → LLM Chat: requests generation
tinytroupe/agent/action_generator.py - LLM Chat → Model Client Registry: selects client
tinytroupe/utils/llm.py - Model Client Registry → OpenAI Client: registers client
tinytroupe/clients/__init__.py - Model Client Registry → Azure Client: registers client
tinytroupe/clients/__init__.py - Model Client Registry → Ollama Client: registers client
tinytroupe/clients/__init__.py - Simulation World → Simulated Person: runs agents
tinytroupe/environment/tiny_world.py - Simulation World → Simulation Control: uses control
tinytroupe/environment/tiny_world.py - Simulation World → Social Network: supports social structure
- Experimenter → Experiment Runner: runs experiments
README.md - Experiment Runner → Propositions: evaluates propositions
- Empirical Validation → Statistical Tests: uses tests
tinytroupe/validation/simulation_validator.py - Empirical Validation → Simulated Person: validates simulation
- Experimenter → Results Extraction: extracts results
- Results Extraction → Result Normalization: normalizes results
- Experimenter → Results Reporting: reports findings
- Experimenter → Artifact Export: exports artifacts
- Experimenter → Interventions: steers simulation
tinytroupe/steering/intervention.py - Experimenter → Simulation Stories: defines scenarios
- Experimenter → Persona Enrichment: enriches personas
- Experimenter → Persona Styling: styles personas
- Simulated Person → Agent Tools: uses tools
- Agent Tools → Calendar Tool: includes tool
- Agent Tools → Word Processor: includes tool
- Experimenter → Jupyter Interaction: interacts in notebook
README.md