<p align="center">
<img src="https://raw.githubusercontent.com/heraclitus0/cognize/main/assets/logo.png" width="180"/>
</p>
<h1 align="center">Cognize</h1>
<p align="center"><em>Programmable cognition for Python systems</em></p>
<p align="center">
<a href="https://pypi.org/project/cognize"><img src="https://img.shields.io/pypi/v/cognize?color=blue&label=version" alt="Version"></a>
<img src="https://img.shields.io/badge/python-3.8+-blue">
<img src="https://img.shields.io/badge/status-beta-orange">
<img src="https://img.shields.io/badge/license-Apache%202.0-blue">
</p>
---
## Overview
**Cognize** is a lightweight cognition engine for Python systems.
It tracks belief (`V`) vs. reality (`R`), manages misalignment memory (`E`), and detects symbolic rupture (`Θ`).
Now supports runtime injection of programmable logic for collapse, realignment, and adaptive thresholds.
Built for agents, simulations, filters, and symbolic drift-aware systems.
---
## Features
- Cognitive projection engine (`EpistemicState`)
- Drift tracking with misalignment memory
- Programmable `inject_policy(...)` support
- Prebuilt logic in `cognize.policies` (collapse, realign, threshold)
- Vector-compatible input support
- Trace export (`.json`, `.csv`) for audit or training
- Lightweight, domain-agnostic, DSL-ready
---
## Installation
```bash
pip install cognize
```
---
## Core Concepts
| Symbol | Meaning |
|--------|---------------------|
| `V` | Belief / Projection |
| `R` | Reality Signal |
| `∆` | Distortion |
| `Θ` | Rupture Threshold |
| `E` | Misalignment Memory |
---
## Quick Usage
```python
from cognize import EpistemicState
# Initialize agent
agent = EpistemicState(V0=0.0, threshold=0.35)
# Feed signals
for R in [0.1, 0.3, 0.6, 0.8]:
agent.receive(R)
print(agent.summary())
```
## Example Output
```jason
{'id': 'ccd84e81', 't': 1, 'V': 0.03, 'E': 0.00003, 'Θ': 0.35, 'ruptures': 0, 'last_symbol': '⊙', 'identity': {}}
{'id': 'ccd84e81', 't': 2, 'V': 0.11, 'E': 0.0324, 'Θ': 0.35, 'ruptures': 0, 'last_symbol': '⊙', 'identity': {}}
{'id': 'ccd84e81', 't': 3, 'V': 0.0, 'E': 0.0, 'Θ': 0.35, 'ruptures': 1, 'last_symbol': '⚠', 'identity': {}}
{'id': 'ccd84e81', 't': 4, 'V': 0.0, 'E': 0.0, 'Θ': 0.35, 'ruptures': 2, 'last_symbol': '⚠', 'identity': {}}
```
---
[Full Cognize User Guide](https://github.com/heraclitus0/cognize/blob/main/docs/USER_GUIDE.md)
---
## License
Licensed under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).
---
© 2025 Pulikanti Sashi Bharadwaj
All rights reserved.
Raw data
{
"_id": null,
"home_page": "https://github.com/heraclitus0/cognize",
"name": "cognize",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "cognition, epistemic, rupture, projection, AI, symbolic, drift",
"author": "Pulikanti Sashi Bharadwaj",
"author_email": "Pulikanti Sashi Bharadwaj <bharadwajpulikanti11@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/9d/d4/0650110ec26aa8069fb2eb2624ff214a814738d08f06f948efd6cb7661d3/cognize-0.1.5.tar.gz",
"platform": null,
"description": "<p align=\"center\">\r\n <img src=\"https://raw.githubusercontent.com/heraclitus0/cognize/main/assets/logo.png\" width=\"180\"/>\r\n</p>\r\n\r\n<h1 align=\"center\">Cognize</h1>\r\n\r\n<p align=\"center\"><em>Programmable cognition for Python systems</em></p>\r\n\r\n<p align=\"center\">\r\n <a href=\"https://pypi.org/project/cognize\"><img src=\"https://img.shields.io/pypi/v/cognize?color=blue&label=version\" alt=\"Version\"></a>\r\n <img src=\"https://img.shields.io/badge/python-3.8+-blue\">\r\n <img src=\"https://img.shields.io/badge/status-beta-orange\">\r\n <img src=\"https://img.shields.io/badge/license-Apache%202.0-blue\">\r\n</p>\r\n\r\n---\r\n\r\n## Overview\r\n\r\n**Cognize** is a lightweight cognition engine for Python systems. \r\nIt tracks belief (`V`) vs. reality (`R`), manages misalignment memory (`E`), and detects symbolic rupture (`\u0398`). \r\nNow supports runtime injection of programmable logic for collapse, realignment, and adaptive thresholds.\r\n\r\nBuilt for agents, simulations, filters, and symbolic drift-aware systems.\r\n\r\n---\r\n\r\n## Features\r\n\r\n- Cognitive projection engine (`EpistemicState`)\r\n- Drift tracking with misalignment memory\r\n- Programmable `inject_policy(...)` support\r\n- Prebuilt logic in `cognize.policies` (collapse, realign, threshold)\r\n- Vector-compatible input support\r\n- Trace export (`.json`, `.csv`) for audit or training\r\n- Lightweight, domain-agnostic, DSL-ready\r\n\r\n---\r\n\r\n## Installation\r\n\r\n```bash\r\npip install cognize\r\n```\r\n\r\n---\r\n\r\n## Core Concepts\r\n\r\n| Symbol | Meaning |\r\n|--------|---------------------|\r\n| `V` | Belief / Projection |\r\n| `R` | Reality Signal |\r\n| `\u2206` | Distortion |\r\n| `\u0398` | Rupture Threshold |\r\n| `E` | Misalignment Memory |\r\n\r\n---\r\n\r\n## Quick Usage\r\n\r\n```python\r\nfrom cognize import EpistemicState\r\n\r\n# Initialize agent\r\nagent = EpistemicState(V0=0.0, threshold=0.35)\r\n\r\n# Feed signals\r\nfor R in [0.1, 0.3, 0.6, 0.8]:\r\n agent.receive(R)\r\n print(agent.summary())\r\n```\r\n\r\n\r\n## Example Output\r\n\r\n```jason\r\n{'id': 'ccd84e81', 't': 1, 'V': 0.03, 'E': 0.00003, '\u0398': 0.35, 'ruptures': 0, 'last_symbol': '\u2299', 'identity': {}} \r\n{'id': 'ccd84e81', 't': 2, 'V': 0.11, 'E': 0.0324, '\u0398': 0.35, 'ruptures': 0, 'last_symbol': '\u2299', 'identity': {}}\r\n{'id': 'ccd84e81', 't': 3, 'V': 0.0, 'E': 0.0, '\u0398': 0.35, 'ruptures': 1, 'last_symbol': '\u26a0', 'identity': {}} \r\n{'id': 'ccd84e81', 't': 4, 'V': 0.0, 'E': 0.0, '\u0398': 0.35, 'ruptures': 2, 'last_symbol': '\u26a0', 'identity': {}}\r\n```\r\n\r\n\r\n\r\n---\r\n\r\n[Full Cognize User Guide](https://github.com/heraclitus0/cognize/blob/main/docs/USER_GUIDE.md)\r\n\r\n---\r\n\r\n## License\r\n\r\nLicensed under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).\r\n\r\n---\r\n\r\n\u00a9 2025 Pulikanti Sashi Bharadwaj \r\nAll rights reserved.\r\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Symbolic cognition engine for epistemic drift, rupture detection, and realignment.",
"version": "0.1.5",
"project_urls": {
"Homepage": "https://github.com/heraclitus0/cognize",
"Issues": "https://github.com/heraclitus0/cognize/issues",
"Source": "https://github.com/heraclitus0/cognize",
"UserGuide": "https://github.com/heraclitus0/cognize/blob/main/docs/USER_GUIDE.md"
},
"split_keywords": [
"cognition",
" epistemic",
" rupture",
" projection",
" ai",
" symbolic",
" drift"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a15dd5c85055ed19b56cb869287c5b673f1fb857b357d2d49a84c6f67ef705ad",
"md5": "57abff4eb17be56ab8c4c713498964c3",
"sha256": "475e0ae4c9707a8d72c8b1e87112f90d90a55c2aaed74bc92cb41dc09bc5fc0e"
},
"downloads": -1,
"filename": "cognize-0.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "57abff4eb17be56ab8c4c713498964c3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 11618,
"upload_time": "2025-08-02T02:41:35",
"upload_time_iso_8601": "2025-08-02T02:41:35.408767Z",
"url": "https://files.pythonhosted.org/packages/a1/5d/d5c85055ed19b56cb869287c5b673f1fb857b357d2d49a84c6f67ef705ad/cognize-0.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "9dd40650110ec26aa8069fb2eb2624ff214a814738d08f06f948efd6cb7661d3",
"md5": "37779456921d4904b0f73931329a93f6",
"sha256": "16163ca7d8c283b42623ff0e65fd62f7ddda8f5fd5cb5b54b549c391a78af9f3"
},
"downloads": -1,
"filename": "cognize-0.1.5.tar.gz",
"has_sig": false,
"md5_digest": "37779456921d4904b0f73931329a93f6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 13335,
"upload_time": "2025-08-02T02:41:36",
"upload_time_iso_8601": "2025-08-02T02:41:36.728995Z",
"url": "https://files.pythonhosted.org/packages/9d/d4/0650110ec26aa8069fb2eb2624ff214a814738d08f06f948efd6cb7661d3/cognize-0.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-02 02:41:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "heraclitus0",
"github_project": "cognize",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "numpy",
"specs": [
[
">=",
"1.21"
]
]
},
{
"name": "pandas",
"specs": [
[
">=",
"1.3"
]
]
},
{
"name": "matplotlib",
"specs": [
[
">=",
"3.4"
]
]
}
],
"lcname": "cognize"
}
JSON
