Projective Simulation
================
<!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->
<p align="center">
<img width="250" src="figs/ps_logo.png">
</p>
<h3 align="center">
<em>Agency • Learning • Physics</em>
</h3>
<p align="center">
<a href="https://badge.fury.io/py/projective_simulation"><img src="https://badge.fury.io/py/projective_simulation.svg" alt="PyPI version"></a>
<a href="https://badge.fury.io/py/projective_simulation"><img src="https://img.shields.io/badge/python-3.10-red" alt="Python version"></a>
</p>
<p align="center">
<a href="https://qic-ibk.github.io/projective_simulation/">Get
started</a> \|
<a href="https://qic-ibk.github.io/projective_simulation/lib_nbs/index_docs.html">Documentation</a>
\|
<a href="https://qic-ibk.github.io/projective_simulation/tutorials/index_tutorials.html">Tutorials</a>
</p>
Projective Simulation (PS) is a framework for studying agency from a
physical perspective. PS agents learn from interaction with their
environment and base their decisions on **episodic memory**. Internally,
their deliberation corresponds to **random walks on a clip network
(graph)**, which provides an interpretable route to physical
realizations and analysis.
This library all the necessary tools to develop, deploy and train PS
agents in a variety of environments. Its content spans from entry-level
[tutorials](tutorials/index_tutorials.ipynb) that introduce the core
principles of PS to cutting-edge [research](webpage/research.ipynb) on
the latest developments and applications. It is actively developed by
the [QIC group at UIBK](https://www.uibk.ac.at/en/th-physik/qic-group/).
## Installation
Projective simulation is available for `python>=3.10` via
``` python
pip install projective_simulation
```
This will also install the necessary library requirements.
## Getting Started
To begin exploring Projective Simulation, we recommend to start with the
[tutorials](tutorials/index_tutorials.ipynb), which contain from the
basics to more advance applications.
If you want to develop or deploy PS agents, please check the
[documetation](lib_nbs/index_docs.ipynb).
## Citing
If you found this package useful and used it in your projects, you can
either the particular PS paper that you found most useful (see a list
[here](figs/PS_mindmap.html)) or use the following to cite the whole
library:
``` python
here will be some zenodo link
```
Raw data
{
"_id": null,
"home_page": "https://github.com/{user}/projective_simulation/",
"name": "projective-simulation",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "RL, ML",
"author": "QIC-UIBK",
"author_email": "gorka.munoz-gil@uibk.ac.at",
"download_url": "https://files.pythonhosted.org/packages/bb/40/84dc3965dcf5b7a4c80c5f88f5fd3189a260f42fc3ce2f360ae6f93e53ac/projective_simulation-0.0.1.tar.gz",
"platform": null,
"description": "Projective Simulation\n================\n\n<!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->\n<p align=\"center\">\n<img width=\"250\" src=\"figs/ps_logo.png\">\n</p>\n<h3 align=\"center\">\n<em>Agency \u2022 Learning \u2022 Physics</em>\n</h3>\n<p align=\"center\">\n<a href=\"https://badge.fury.io/py/projective_simulation\"><img src=\"https://badge.fury.io/py/projective_simulation.svg\" alt=\"PyPI version\"></a>\n<a href=\"https://badge.fury.io/py/projective_simulation\"><img src=\"https://img.shields.io/badge/python-3.10-red\" alt=\"Python version\"></a>\n</p>\n<p align=\"center\">\n<a href=\"https://qic-ibk.github.io/projective_simulation/\">Get\nstarted</a> \\|\n<a href=\"https://qic-ibk.github.io/projective_simulation/lib_nbs/index_docs.html\">Documentation</a>\n\\|\n<a href=\"https://qic-ibk.github.io/projective_simulation/tutorials/index_tutorials.html\">Tutorials</a>\n</p>\n\nProjective Simulation (PS) is a framework for studying agency from a\nphysical perspective. PS agents learn from interaction with their\nenvironment and base their decisions on **episodic memory**. Internally,\ntheir deliberation corresponds to **random walks on a clip network\n(graph)**, which provides an interpretable route to physical\nrealizations and analysis.\n\nThis library all the necessary tools to develop, deploy and train PS\nagents in a variety of environments. Its content spans from entry-level\n[tutorials](tutorials/index_tutorials.ipynb) that introduce the core\nprinciples of PS to cutting-edge [research](webpage/research.ipynb) on\nthe latest developments and applications. It is actively developed by\nthe [QIC group at UIBK](https://www.uibk.ac.at/en/th-physik/qic-group/).\n\n## Installation\n\nProjective simulation is available for `python>=3.10` via\n\n``` python\npip install projective_simulation\n```\n\nThis will also install the necessary library requirements.\n\n## Getting Started\n\nTo begin exploring Projective Simulation, we recommend to start with the\n[tutorials](tutorials/index_tutorials.ipynb), which contain from the\nbasics to more advance applications.\n\nIf you want to develop or deploy PS agents, please check the\n[documetation](lib_nbs/index_docs.ipynb).\n\n## Citing\n\nIf you found this package useful and used it in your projects, you can\neither the particular PS paper that you found most useful (see a list\n[here](figs/PS_mindmap.html)) or use the following to cite the whole\nlibrary:\n\n``` python\nhere will be some zenodo link\n```\n",
"bugtrack_url": null,
"license": "Apache Software License 2.0",
"summary": "Library for Projective Simulation",
"version": "0.0.1",
"project_urls": {
"Homepage": "https://github.com/{user}/projective_simulation/"
},
"split_keywords": [
"rl",
" ml"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "cd90b16510e1be2e23d4aebd1c6ea92157cb6a85b132cfdcec6361f8bae9c014",
"md5": "56ea63e669f0f2aa4d1e4d93ac2bc50b",
"sha256": "2af248483a3f5bc4d00d7dcf94e8b88219e40fbd823dcad37f9f5d0686835e95"
},
"downloads": -1,
"filename": "projective_simulation-0.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "56ea63e669f0f2aa4d1e4d93ac2bc50b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 19062,
"upload_time": "2025-08-31T12:16:34",
"upload_time_iso_8601": "2025-08-31T12:16:34.989513Z",
"url": "https://files.pythonhosted.org/packages/cd/90/b16510e1be2e23d4aebd1c6ea92157cb6a85b132cfdcec6361f8bae9c014/projective_simulation-0.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "bb4084dc3965dcf5b7a4c80c5f88f5fd3189a260f42fc3ce2f360ae6f93e53ac",
"md5": "d58290e2c2f37f313e91d6e4b46c7c43",
"sha256": "dff9ec4b91e7f5d242e294d9a25424382ff9ed656da34c079f00e64f1973e3df"
},
"downloads": -1,
"filename": "projective_simulation-0.0.1.tar.gz",
"has_sig": false,
"md5_digest": "d58290e2c2f37f313e91d6e4b46c7c43",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 17344,
"upload_time": "2025-08-31T12:16:36",
"upload_time_iso_8601": "2025-08-31T12:16:36.538028Z",
"url": "https://files.pythonhosted.org/packages/bb/40/84dc3965dcf5b7a4c80c5f88f5fd3189a260f42fc3ce2f360ae6f93e53ac/projective_simulation-0.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-31 12:16:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "{user}",
"github_project": "projective_simulation",
"github_not_found": true,
"lcname": "projective-simulation"
}