index.html

<!DOCTYPE html>
<html lang="en" data-accent-color="violet" data-content_root="./">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0"><title>cognition documentation</title><link rel="shortcut icon" href="_static/favicon.ico"/><link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Core Concepts" href="ideas/index.html" /><script>
    function setColorMode(t){let e=document.documentElement;e.setAttribute("data-color-mode",t);let a=window.matchMedia&&window.matchMedia("(prefers-color-scheme: dark)").matches,s=t;"auto"===t&&(s=a?"dark":"light"),"light"===s?(e.classList.remove("dark"),e.classList.add("light")):(e.classList.remove("light"),e.classList.add("dark"))}
    setColorMode(localStorage._theme||"auto");
  </script><link rel="stylesheet" type="text/css" href="_static/pygments.css?v=e1a1ceaf" />
    <link rel="stylesheet" type="text/css" href="_static/shibuya.css?v=44020203" />
    <link rel="stylesheet" type="text/css" href="_static/graphviz.css?v=4ae1632d" />
    <link rel="stylesheet" type="text/css" href="_static/copybutton.css?v=76b2166b" />
    <link media="print" rel="stylesheet" type="text/css" href="_static/print.css?v=20ff2c19" />
    <link rel="stylesheet" type="text/css" href="_static/custom.css?v=6d3d49da" />
    <link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
<style>
:root {
  --sy-f-text: "Inter", var(--sy-f-sys), var(--sy-f-cjk), sans-serif;
  --sy-f-heading: "Inter", var(--sy-f-sys), var(--sy-f-cjk), sans-serif;
}
</style>
    <meta property="og:type" content="website"/><meta property="og:title" content="Documentation"/>
    <meta name="twitter:card" content="summary"/>
  </head>
<body><div class="sy-head">
  <div class="sy-head-blur"></div>
  <div class="sy-head-inner sy-container mx-auto">
    <a class="sy-head-brand" href="#">
      
      
      <strong>cognition</strong>
    </a>
    <div class="sy-head-nav" id="head-nav">
      <nav class="sy-head-links"></nav>
      <div class="sy-head-extra flex items-center print:hidden"><form class="searchbox flex items-center" action="search.html" method="get">
  <input type="text" name="q" placeholder="Search" />
  <kbd>/</kbd>
</form><div class="sy-head-socials"></div></div>
    </div>
    <div class="sy-head-actions flex items-center shrink-0 print:hidden"><button class="js-theme theme-switch flex items-center"
data-aria-auto="Switch to light color mode"
data-aria-light="Switch to dark color mode"
data-aria-dark="Switch to auto color mode">
<i class="i-lucide theme-icon"></i>
</button><button class="md:hidden flex items-center js-menu" aria-label="Menu" type="button" aria-controls="head-nav" aria-expanded="false">
        <div class="hamburger">
          <span class="hamburger_1"></span>
          <span class="hamburger_2"></span>
          <span class="hamburger_3"></span>
        </div>
      </button>
    </div>
  </div>
</div>
<div class="sy-page sy-container flex mx-auto">
  <aside id="lside" class="sy-lside md:w-72 md:shrink-0 print:hidden">
    <div class="sy-lside-inner md:sticky">
      <div class="sy-scrollbar p-6">
        <div class="globaltoc" data-expand-depth="0"><ul>
<li class="toctree-l1"><a class="reference internal" href="ideas/index.html">Core Concepts</a><ul>
<li class="toctree-l2"><a class="reference internal" href="ideas/cogent.html">Cognitive Agent (Cogent)</a></li>
<li class="toctree-l2"><a class="reference internal" href="ideas/kadp.html">Decision Process (DP)</a></li>
<li class="toctree-l2"><a class="reference internal" href="ideas/knowledge.html">World Graph</a></li>
<li class="toctree-l2"><a class="reference internal" href="ideas/language.html">Language</a></li>
<li class="toctree-l2"><a class="reference internal" href="ideas/planning.html">Reasoning: Planning</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cook/index.html">Cookbook</a><ul>
<li class="toctree-l2"><a class="reference internal" href="cook/hello.html">Hello World</a></li>
<li class="toctree-l2"><a class="reference internal" href="cook/counting.html">Some Basics</a></li>
<li class="toctree-l2"><a class="reference internal" href="cook/preference.html">Decision Preferences</a></li>
<li class="toctree-l2"><a class="reference internal" href="cook/planning.html">Search-Based Planning</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="autoapi/index.html">API Reference</a><ul>
<li class="toctree-l2"><a class="reference internal" href="autoapi/cognition/index.html">cognition</a><ul>
<li class="toctree-l3"><a class="reference internal" href="autoapi/cognition/cogent/index.html">cognition.cogent</a><ul>
<li class="toctree-l4"><a class="reference internal" href="autoapi/cognition/cogent/cogent/index.html">cognition.cogent.cogent</a></li>
<li class="toctree-l4"><a class="reference internal" href="autoapi/cognition/cogent/env/index.html">cognition.cogent.env</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="autoapi/cognition/decision/index.html">cognition.decision</a><ul>
<li class="toctree-l4"><a class="reference internal" href="autoapi/cognition/decision/chain/index.html">cognition.decision.chain</a></li>
<li class="toctree-l4"><a class="reference internal" href="autoapi/cognition/decision/core/index.html">cognition.decision.core</a></li>
<li class="toctree-l4"><a class="reference internal" href="autoapi/cognition/decision/dp/index.html">cognition.decision.dp</a></li>
<li class="toctree-l4"><a class="reference internal" href="autoapi/cognition/decision/stage/index.html">cognition.decision.stage</a></li>
<li class="toctree-l4"><a class="reference internal" href="autoapi/cognition/decision/state/index.html">cognition.decision.state</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="autoapi/cognition/knowledge/index.html">cognition.knowledge</a><ul>
<li class="toctree-l4"><a class="reference internal" href="autoapi/cognition/knowledge/organization/index.html">cognition.knowledge.organization</a></li>
<li class="toctree-l4"><a class="reference internal" href="autoapi/cognition/knowledge/representation/index.html">cognition.knowledge.representation</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="autoapi/cognition/language/index.html">cognition.language</a><ul>
<li class="toctree-l4"><a class="reference internal" href="autoapi/cognition/language/classification/index.html">cognition.language.classification</a></li>
<li class="toctree-l4"><a class="reference internal" href="autoapi/cognition/language/description/index.html">cognition.language.description</a></li>
<li class="toctree-l4"><a class="reference internal" href="autoapi/cognition/language/population/index.html">cognition.language.population</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="autoapi/cognition/reasoning/index.html">cognition.reasoning</a><ul>
<li class="toctree-l4"><a class="reference internal" href="autoapi/cognition/reasoning/planning/index.html">cognition.reasoning.planning</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="autoapi/cognition/util/index.html">cognition.util</a><ul>
<li class="toctree-l4"><a class="reference internal" href="autoapi/cognition/util/enumeration/index.html">cognition.util.enumeration</a></li>
<li class="toctree-l4"><a class="reference internal" href="autoapi/cognition/util/functypes/index.html">cognition.util.functypes</a></li>
<li class="toctree-l4"><a class="reference internal" href="autoapi/cognition/util/misc/index.html">cognition.util.misc</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>

        </div>
      </div>
    </div>
  </aside>
  <div class="lside-overlay js-menu" role="button" aria-label="Close left sidebar" aria-controls="lside" aria-expanded="false"></div>
  <aside id="rside" class="sy-rside pb-3 w-64 shrink-0 order-last">
    <button class="rside-close js-menu xl:hidden" aria-label="Close Table of Contents" type="button" aria-controls="rside" aria-expanded="false">
      <i class="i-lucide close"></i>
    </button>
    <div class="sy-scrollbar sy-rside-inner px-6 xl:top-16 xl:sticky xl:pl-0 pt-6 pb-4"><div id="ethical-ad-placement" data-ea-publisher="readthedocs"></div></div>
  </aside>
  <div class="rside-overlay js-menu" role="button" aria-label="Close Table of Contents" aria-controls="rside" aria-expanded="false"></div>
  <main class="sy-main w-full max-sm:max-w-full print:pt-6">
<div class="sy-breadcrumbs" role="navigation">
  <div class="sy-breadcrumbs-inner flex items-center">
    <div class="md:hidden mr-3">
      <button class="js-menu" aria-label="Menu" type="button" aria-controls="lside" aria-expanded="false">
        <i class="i-lucide menu"></i>
      </button>
    </div>
    <ol class="flex-1" itemscope itemtype="https://schema.org/BreadcrumbList"><li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
        <a itemprop="item" href="#"><span itemprop="name">cognition</span></a>
        <span>/</span>
        <meta itemprop="position" content="1" />
      </li><li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
        <strong itemprop="name">Documentation</strong>
        <meta itemprop="position" content="2" />
      </li></ol>
    <div class="xl:hidden ml-1">
      <button class="js-menu" aria-label="Show table of contents" type="button" aria-controls="rside"
        aria-expanded="false">
        <i class="i-lucide outdent"></i>
      </button>
    </div>
  </div>
</div><div class="flex flex-col break-words justify-between">
      <div class="relative min-w-0 max-w-6xl px-6 pb-6 pt-8 xl:px-12">
  <article class="yue" role="main">
          <section class="tex2jax_ignore mathjax_ignore" id="documentation">
<h1>Documentation<a class="headerlink" href="#documentation" title="Link to this heading">¶</a></h1>
<p>Welcome to <code class="docutils literal notranslate"><span class="pre">cognition</span></code> 🧠 an open-source agent framework in Python developed by <a class="reference external" href="https://polycog.ai">Polycog, Inc.</a> The framework implements a <a class="reference external" href="https://en.wikipedia.org/wiki/Neuro-symbolic_AI">neurosymbolic</a> foundation for complex decision-making, natural language processing, structural knowledge representation, and logical &amp; deterministic reasoning. It enables agent developers to build trustworthy agents - agents that are reliable (repeatable, deterministic, provably correct reasoning), steerable (programmatic enforcement of behavior directives), and explainable (causal provenance of all decisions).</p>
<div class="admonition seealso">
<p class="admonition-title">See also</p>
<p>Resources &amp; Getting Started</p>
<ul class="simple">
<li><p><strong><a class="reference external" href="https://cognition.polycog.ai">Open-Core Repository</a></strong>
The open-core GitHub repository for the <code class="docutils literal notranslate"><span class="pre">cognition</span></code> framework.</p></li>
<li><p><strong><a class="reference external" href="https://docs.google.com/videos/d/1ZXO49VgD3pMfTRtArF0UttE5nTFwhVnGZk2fCps2UrU/play?usp=sharing">Demonstration Video</a></strong>
A video demonstration showcasing a neurosymbolic agent parsing natural language intent, maintaining state topologies, and executing multi-step operations.</p></li>
<li><p><strong><a class="reference external" href="https://cognition.polycog.ai/tutorials">Interactive Tutorial Series</a></strong>
A tutorial repository featuring Jupyter Notebooks that take you step-by-step through various concepts in the framework as you build an interactive smart home assistant.</p></li>
</ul>
</div>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>This project is under active development!</p>
</div>
<div class="toctree-wrapper compound">
</div>
</section>

        </article><button class="back-to-top" type="button">
  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
    <path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12z"></path>
  </svg>
  <span>Back to top</span>
</button><div class="navigation flex print:hidden"><div class="navigation-next">
    <a href="ideas/index.html">
      <div class="page-info">
        <span>Next</span>
        <div class="title">Core Concepts</div>
      </div>
      <i class="i-lucide chevron-right"></i>
    </a>
  </div></div></div>
    </div>
  </main>
</div>
<footer class="sy-foot">
  <div class="sy-foot-inner sy-container mx-auto">
    <div class="sy-foot-reserved md:flex justify-between items-center">
      <div class="sy-foot-copyright"><p>2026, Polycog, Inc.</p>
  
  <p>
    Made with
    
    <a href="https://www.sphinx-doc.org/">Sphinx</a> and
    
    <a href="https://shibuya.lepture.com">Shibuya theme</a>.
  </p>
</div>
      <div class="sy-foot-socials"></div>
    </div>
  </div>
</footer>
      <script src="_static/documentation_options.js?v=5929fcd5"></script>
      <script src="_static/doctools.js?v=fd6eb6e6"></script>
      <script src="_static/sphinx_highlight.js?v=6ffebe34"></script>
      <script src="_static/clipboard.min.js?v=a7894cd8"></script>
      <script src="_static/copybutton.js?v=f281be69"></script>
      <script src="_static/shibuya.js?v=cac61aee"></script></body>
</html>