Release v0.5.2

[2025-07-31] Release 0.5.2: Mostly just changes the default model, which is now set to GPT-4.1-mini. It seems to bring considerable quality improvements. Note that GPT-4.1-mini can have significant differences in behavior w.r.t. to the previous default of GPT-4o-mini, so please make sure you retest your important scenarios using GPT-4.1-mini and adjust accordingly.

Release v0.5.1-alpha (including paper resources)

[2025-07-15] Release 0.5.1 with various improvements. Some highlights:

• Released the first version of the TinyTroupe paper (as a preprint), which describes the library and its use cases in more detail. You can find the related experiments and complementary material in the publications/ folder.
• TinyPersons now include action correction mechanisms, allowing better adherence to persona specification, self-consistency and/or fluency (for details, refer to the paper we are releasing at the same time now).
• Substantial improvements to the TinyPersonFactory class, which now: uses a plan-based approach to generate new agents, allowing better sampling of larger populations; generate agents in parallel.
• TinyWorld now run agents in parallel within each simulation step, allowing faster simulations.
• InPlaceExperimentRunner class introduced to allow running controlled experiments (e.g., A/B testing) in a single file (by simply running it multiple times).
  -Various standard Propositions were introduced to make it easier to run common verifications and monitoring of agent behavior (e.g., persona_adherence, hard_persona_adherence, self_consistency, fluency, etc.).
• Internal LLM usage is now better supported via the LLMChat class, and also the @llm decorator, which transform any standard Python function into an LLM-based one (i.e., by using the docstring as part of the prompt, and some other nuances). This is meant to make it easier to continue advancing TinyTroupe and also allow for some creative explorations of LLM tooling possibilities.
• Configuration mechanism has been refactored to allow, besides the static config.ini file, also the dynamic programmatic reconfiguration.
• Renamed Jupyter notebooks examples for better readability and consistency.
  -Added many more tests.

v0.4.0-alpha

What's new

[2025-01-29] Release 0.4.0 with various improvements. Some highlights:

• Personas have deeper specifications now, including personality traits, preferences, beliefs, and more. It is likely we'll further expand this in the future.
• TinyPersons can now be defined as JSON files as well, and loaded via the TinyPerson.load_specification(), for greater convenience. After loading the JSON file, you can still modify the agent programmatically. See the examples/agents/ folder for examples.
• Introduces the concept of fragments to allow the reuse of persona elements across different agents. See the examples/fragments/ folder for examples, and the notebook Political Compass (customizing agents with fragments) for a demonstration.
• Introduces LLM-based logical Propositions, to facilitate the monitoring of agent behavior.
• Introduces Interventions, to allow the specification of event-based modifications to the simulation.
• Submodules have their own folders now, to allow better organization and growth.

Note: this will likely break some existing programs, as the API has changed in some places.

PRs from the community and the core team

• allow configuration of Azure OpenAI embedding model by @ewheeler in #59
• Fix spelling and grammatical errors by @terrchen in #19
• Change to use de facto standard for dotenv sample by @webysther in #22
• fix typo, call semantic_memory method of agent not self by @ewheeler in #57
• docs: update README.md by @eltociear in #24
• Add matplotlib to dependencies by @RektPunk in #33
• variable typo #18 fixed by @rahimbaig28 in #25
• also retry aux_act_once upon TypeError by @ewheeler in #58
• Adds deeper persona structure, including fragments. by @paulosalem in #86
• Merges latest development version into main. by @paulosalem in #90

New Contributors

• @ewheeler made their first contribution in #59
• @terrchen made their first contribution in #19
• @webysther made their first contribution in #22
• @eltociear made their first contribution in #24
• @RektPunk made their first contribution in #33
• @rahimbaig28 made their first contribution in #25

Full Changelog: v0.3.1-alpha...v0.4.0-alpha

Initial public release + minor updates (v0.3.1-alpha)

Initial public release, plus some minor updates.