Hugging Face's logo

Spaces:
AUXteam
/
tiny_factory
Paused

App Files Community
tiny_factory / htmlcov /z_357ee38f49d3e320___init___py.html
AUXteam's picture
AUXteam
Upload folder using huggingface_hub
7a0719c verified
raw
history blame contribute delete
21 kB
<!DOCTYPE html>
<html lang="en">
<head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
 <title>Coverage for tinytroupe/agent/__init__.py: 0%</title>
 <link rel="icon" sizes="32x32" href="favicon_32_cb_c827f16f.png">
 <link rel="stylesheet" href="style_cb_9ff733b0.css" type="text/css">
 <script src="coverage_html_cb_dd2e7eb5.js" defer></script>
</head>
<body class="pyfile">
<header>
 <div class="content">
 <h1>
 <span class="text">Coverage for </span><b>tinytroupe&#8201;/&#8201;agent&#8201;/&#8201;__init__.py</b>:
 <span class="pc_cov">0%</span>
 </h1>
 <aside id="help_panel_wrapper">
 <input id="help_panel_state" type="checkbox">
 <label for="help_panel_state">
 <img id="keyboard_icon" src="keybd_closed_cb_900cfef5.png" alt="Show/hide keyboard shortcuts">
 </label>
 <div id="help_panel">
 <p class="legend">Shortcuts on this page</p>
 <div class="keyhelp">
 <p>
 <kbd>r</kbd>
 <kbd>m</kbd>
 <kbd>x</kbd>
 &nbsp; toggle line displays
 </p>
 <p>
 <kbd>j</kbd>
 <kbd>k</kbd>
 &nbsp; next/prev highlighted chunk
 </p>
 <p>
 <kbd>0</kbd> &nbsp; (zero) top of page
 </p>
 <p>
 <kbd>1</kbd> &nbsp; (one) first highlighted chunk
 </p>
 <p>
 <kbd>[</kbd>
 <kbd>]</kbd>
 &nbsp; prev/next file
 </p>
 <p>
 <kbd>u</kbd> &nbsp; up to the index
 </p>
 <p>
 <kbd>?</kbd> &nbsp; show/hide this help
 </p>
 </div>
 </div>
 </aside>
 <h2>
 <span class="text">28 statements &nbsp;</span>
 <button type="button" class="run button_toggle_run" value="run" data-shortcut="r" title="Toggle lines run">0<span class="text"> run</span></button>
 <button type="button" class="mis show_mis button_toggle_mis" value="mis" data-shortcut="m" title="Toggle lines missing">28<span class="text"> missing</span></button>
 <button type="button" class="exc show_exc button_toggle_exc" value="exc" data-shortcut="x" title="Toggle lines excluded">0<span class="text"> excluded</span></button>
 </h2>
 <p class="text">
 <a id="prevFileLink" class="nav" href="z_8e144f0c9fd03088___init___py.html">&#xab; prev</a> &nbsp; &nbsp;
 <a id="indexLink" class="nav" href="index.html">&Hat; index</a> &nbsp; &nbsp;
 <a id="nextFileLink" class="nav" href="z_357ee38f49d3e320_action_generator_py.html">&#xbb; next</a>
 &nbsp; &nbsp; &nbsp;
 <a class="nav" href="https://coverage.readthedocs.io/en/7.13.4">coverage.py v7.13.4</a>,
 created at 2026-02-28 17:48 +0000
 </p>
 <aside class="hidden">
 <button type="button" class="button_next_chunk" data-shortcut="j"></button>
 <button type="button" class="button_prev_chunk" data-shortcut="k"></button>
 <button type="button" class="button_top_of_page" data-shortcut="0"></button>
 <button type="button" class="button_first_chunk" data-shortcut="1"></button>
 <button type="button" class="button_prev_file" data-shortcut="["></button>
 <button type="button" class="button_next_file" data-shortcut="]"></button>
 <button type="button" class="button_to_index" data-shortcut="u"></button>
 <button type="button" class="button_show_hide_help" data-shortcut="?"></button>
 </aside>
 </div>
</header>
<main id="source">
 <p class="pln"><span class="n"><a id="t1" href="#t1">1</a></span><span class="t"><span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t2" href="#t2">2</a></span><span class="t"><span class="str">This module provides the main classes and functions for TinyTroupe's agents.</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t3" href="#t3">3</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t4" href="#t4">4</a></span><span class="t"><span class="str">Agents are the key abstraction used in TinyTroupe. An agent is a simulated person or entity that can interact with other agents and the environment, by</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t5" href="#t5">5</a></span><span class="t"><span class="str">receiving stimuli and producing actions. Agents have cognitive states, which are updated as they interact with the environment and other agents. </span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t6" href="#t6">6</a></span><span class="t"><span class="str">Agents can also store and retrieve information from memory, and can perform actions in the environment. Different from agents whose objective is to</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t7" href="#t7">7</a></span><span class="t"><span class="str">provide support for AI-based assistants or other such productivity tools, **TinyTroupe agents aim at representing human-like behavior**, which includes</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t8" href="#t8">8</a></span><span class="t"><span class="str">idiossincracies, emotions, and other human-like traits, that one would not expect from a productivity tool.</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t9" href="#t9">9</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t10" href="#t10">10</a></span><span class="t"><span class="str">The overall underlying design is inspired mainly by Cognitive Psychology, which is why agents have various internal cognitive states, such as attention, emotions, and goals.</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t11" href="#t11">11</a></span><span class="t"><span class="str">It is also why agent memory, differently from other LLM-based agent platforms, has subtle internal divisions, notably between episodic and semantic memory. </span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t12" href="#t12">12</a></span><span class="t"><span class="str">Some behaviorist concepts are also present, such as the explicit and decoupled concepts of "stimulus" and "response" in the `listen` and `act` methods, which are key abstractions</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t13" href="#t13">13</a></span><span class="t"><span class="str">to understand how agents interact with the environment and other agents.</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t14" href="#t14">14</a></span><span class="t"><span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t15" href="#t15">15</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t16" href="#t16">16</a></span><span class="t"><span class="key">import</span> <span class="nam">tinytroupe</span><span class="op">.</span><span class="nam">utils</span> <span class="key">as</span> <span class="nam">utils</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t17" href="#t17">17</a></span><span class="t"><span class="key">from</span> <span class="nam">pydantic</span> <span class="key">import</span> <span class="nam">BaseModel</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t18" href="#t18">18</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t19" href="#t19">19</a></span><span class="t"><span class="key">import</span> <span class="nam">logging</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t20" href="#t20">20</a></span><span class="t"><span class="nam">logger</span> <span class="op">=</span> <span class="nam">logging</span><span class="op">.</span><span class="nam">getLogger</span><span class="op">(</span><span class="str">"tinytroupe"</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t21" href="#t21">21</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t22" href="#t22">22</a></span><span class="t"><span class="key">from</span> <span class="nam">tinytroupe</span> <span class="key">import</span> <span class="nam">default</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t23" href="#t23">23</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t24" href="#t24">24</a></span><span class="t"><span class="com">###########################################################################</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t25" href="#t25">25</a></span><span class="t"><span class="com"># Types and constants</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t26" href="#t26">26</a></span><span class="t"><span class="com">###########################################################################</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t27" href="#t27">27</a></span><span class="t"><span class="key">from</span> <span class="nam">typing</span> <span class="key">import</span> <span class="nam">TypeVar</span><span class="op">,</span> <span class="nam">Union</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t28" href="#t28">28</a></span><span class="t"><span class="nam">Self</span> <span class="op">=</span> <span class="nam">TypeVar</span><span class="op">(</span><span class="str">"Self"</span><span class="op">,</span> <span class="nam">bound</span><span class="op">=</span><span class="str">"TinyPerson"</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t29" href="#t29">29</a></span><span class="t"><span class="nam">AgentOrWorld</span> <span class="op">=</span> <span class="nam">Union</span><span class="op">[</span><span class="nam">Self</span><span class="op">,</span> <span class="str">"TinyWorld"</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t30" href="#t30">30</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t31" href="#t31">31</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t32" href="#t32">32</a></span><span class="t"><span class="com">###########################################################################</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t33" href="#t33">33</a></span><span class="t"><span class="com"># Data structures to enforce output format during LLM API call.</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t34" href="#t34">34</a></span><span class="t"><span class="com">###########################################################################</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t35" href="#t35">35</a></span><span class="t"><span class="key">class</span> <span class="nam">Action</span><span class="op">(</span><span class="nam">BaseModel</span><span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t36" href="#t36">36</a></span><span class="t"> <span class="nam">type</span><span class="op">:</span> <span class="nam">str</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t37" href="#t37">37</a></span><span class="t"> <span class="nam">content</span><span class="op">:</span> <span class="nam">str</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t38" href="#t38">38</a></span><span class="t"> <span class="nam">target</span><span class="op">:</span> <span class="nam">str</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t39" href="#t39">39</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t40" href="#t40">40</a></span><span class="t"><span class="key">class</span> <span class="nam">CognitiveState</span><span class="op">(</span><span class="nam">BaseModel</span><span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t41" href="#t41">41</a></span><span class="t"> <span class="nam">goals</span><span class="op">:</span> <span class="nam">str</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t42" href="#t42">42</a></span><span class="t"> <span class="nam">context</span><span class="op">:</span> <span class="nam">list</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t43" href="#t43">43</a></span><span class="t"> <span class="nam">attention</span><span class="op">:</span> <span class="nam">str</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t44" href="#t44">44</a></span><span class="t"> <span class="nam">emotions</span><span class="op">:</span> <span class="nam">str</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t45" href="#t45">45</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t46" href="#t46">46</a></span><span class="t"><span class="key">class</span> <span class="nam">CognitiveActionModel</span><span class="op">(</span><span class="nam">BaseModel</span><span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t47" href="#t47">47</a></span><span class="t"> <span class="nam">action</span><span class="op">:</span> <span class="nam">Action</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t48" href="#t48">48</a></span><span class="t"> <span class="nam">cognitive_state</span><span class="op">:</span> <span class="nam">CognitiveState</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t49" href="#t49">49</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t50" href="#t50">50</a></span><span class="t"><span class="key">class</span> <span class="nam">CognitiveActionModelWithReasoning</span><span class="op">(</span><span class="nam">BaseModel</span><span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t51" href="#t51">51</a></span><span class="t"> <span class="nam">reasoning</span><span class="op">:</span> <span class="nam">str</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t52" href="#t52">52</a></span><span class="t"> <span class="nam">action</span><span class="op">:</span> <span class="nam">Action</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t53" href="#t53">53</a></span><span class="t"> <span class="nam">cognitive_state</span><span class="op">:</span> <span class="nam">CognitiveState</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t54" href="#t54">54</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t55" href="#t55">55</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t56" href="#t56">56</a></span><span class="t"><span class="com">###########################################################################</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t57" href="#t57">57</a></span><span class="t"><span class="com"># Exposed API</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t58" href="#t58">58</a></span><span class="t"><span class="com">###########################################################################</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t59" href="#t59">59</a></span><span class="t"><span class="com"># from. grounding ... ---> not exposing this, clients should not need to know about detailed grounding mechanisms</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t60" href="#t60">60</a></span><span class="t"><span class="key">from</span> <span class="op">.</span><span class="nam">memory</span> <span class="key">import</span> <span class="nam">SemanticMemory</span><span class="op">,</span> <span class="nam">EpisodicMemory</span><span class="op">,</span> <span class="nam">EpisodicConsolidator</span><span class="op">,</span> <span class="nam">ReflectionConsolidator</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t61" href="#t61">61</a></span><span class="t"><span class="key">from</span> <span class="op">.</span><span class="nam">mental_faculty</span> <span class="key">import</span> <span class="nam">CustomMentalFaculty</span><span class="op">,</span> <span class="nam">RecallFaculty</span><span class="op">,</span> <span class="nam">FilesAndWebGroundingFaculty</span><span class="op">,</span> <span class="nam">TinyToolUse</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t62" href="#t62">62</a></span><span class="t"><span class="key">from</span> <span class="op">.</span><span class="nam">tiny_person</span> <span class="key">import</span> <span class="nam">TinyPerson</span>&nbsp;</span><span class="r"></span></p>
 <p class="pln"><span class="n"><a id="t63" href="#t63">63</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
 <p class="mis show_mis"><span class="n"><a id="t64" href="#t64">64</a></span><span class="t"><span class="nam">__all__</span> <span class="op">=</span> <span class="op">[</span><span class="str">"SemanticMemory"</span><span class="op">,</span> <span class="str">"EpisodicMemory"</span><span class="op">,</span> <span class="str">"EpisodicConsolidator"</span><span class="op">,</span> <span class="str">"ReflectionConsolidator"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis mis2 show_mis"><span class="n"><a id="t65" href="#t65">65</a></span><span class="t"> <span class="str">"CustomMentalFaculty"</span><span class="op">,</span> <span class="str">"RecallFaculty"</span><span class="op">,</span> <span class="str">"FilesAndWebGroundingFaculty"</span><span class="op">,</span> <span class="str">"TinyToolUse"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
 <p class="mis mis2 show_mis"><span class="n"><a id="t66" href="#t66">66</a></span><span class="t"> <span class="str">"TinyPerson"</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
</main>
<footer>
 <div class="content">
 <p>
 <a class="nav" href="z_8e144f0c9fd03088___init___py.html">&#xab; prev</a> &nbsp; &nbsp;
 <a class="nav" href="index.html">&Hat; index</a> &nbsp; &nbsp;
 <a class="nav" href="z_357ee38f49d3e320_action_generator_py.html">&#xbb; next</a>
 &nbsp; &nbsp; &nbsp;
 <a class="nav" href="https://coverage.readthedocs.io/en/7.13.4">coverage.py v7.13.4</a>,
 created at 2026-02-28 17:48 +0000
 </p>
 </div>
</footer>
</body>
</html>