{"id":23084123,"url":"https://github.com/murraylab/psychrnn","last_synced_at":"2025-04-07T05:15:14.244Z","repository":{"id":48841180,"uuid":"152650145","full_name":"murraylab/PsychRNN","owner":"murraylab","description":null,"archived":false,"fork":false,"pushed_at":"2023-11-05T20:01:23.000Z","size":1848,"stargazers_count":137,"open_issues_count":5,"forks_count":42,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-07T05:15:03.791Z","etag":null,"topics":["cognitive-neural-processes","neural-networks","recurrent-neural-networks","tensorflow"],"latest_commit_sha":null,"homepage":"https://psychrnn.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/murraylab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2018-10-11T20:13:41.000Z","updated_at":"2025-04-03T06:53:55.000Z","dependencies_parsed_at":"2023-02-14T10:46:43.080Z","dependency_job_id":"1a97e115-23e2-4e94-9175-fbdce427ee2d","html_url":"https://github.com/murraylab/PsychRNN","commit_stats":{"total_commits":87,"total_committers":9,"mean_commits":9.666666666666666,"dds":0.5287356321839081,"last_synced_commit":"2f5415534de786b2901fd3b5914d94c94a0f68fa"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/murraylab%2FPsychRNN","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/murraylab%2FPsychRNN/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/murraylab%2FPsychRNN/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/murraylab%2FPsychRNN/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/murraylab","download_url":"https://codeload.github.com/murraylab/PsychRNN/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247595335,"owners_count":20963943,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cognitive-neural-processes","neural-networks","recurrent-neural-networks","tensorflow"],"created_at":"2024-12-16T15:49:08.678Z","updated_at":"2025-04-07T05:15:14.221Z","avatar_url":"https://github.com/murraylab.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PsychRNN\n[![tests](https://github.com/murraylab/PsychRNN/workflows/tests/badge.svg)](https://github.com/murraylab/PsychRNN/actions?query=workflow%3Atests)\n[![codecov](https://codecov.io/gh/murraylab/PsychRNN/branch/master/graph/badge.svg)](https://codecov.io/gh/murraylab/PsychRNN)\n[![Documentation Status](https://readthedocs.org/projects/psychrnn/badge/?version=latest)](https://psychrnn.readthedocs.io/en/latest/?badge=latest)\n\n**Paper:**\n\nEhrlich, D. B.\u003csup\u003e\\*\u003c/sup\u003e, Stone, J. T.\u003csup\u003e\\*\u003c/sup\u003e, Brandfonbrener, D., Atanasov, A., \u0026 Murray, J. D. (2021). PsychRNN: An Accessible and Flexible Python Package for Training Recurrent Neural Network Models on Cognitive Tasks. *ENeuro, 8*(1). [\\[DOI\\]](https://doi.org/10.1523/ENEURO.0427-20.2020)\n\n**Presentation:**\n\nPrefer listening to a 15 minute talk to see if PsychRNN is for you? Check out our [talk at Neuromatch 3.0](https://www.youtube.com/watch?v=OY_Ix-QwB4Y).\n\n## Overview\n\nFull documentation is available at [psychrnn.readthedocs.io](https://psychrnn.readthedocs.io/).\n\nThis package is intended to help cognitive scientists easily translate task designs from human or primate behavioral experiments into a form capable of being used as training data for a recurrent neural network.\n\nWe have isolated the front-end task design, in which users can intuitively describe the conditional logic of their task from the backend where gradient descent based optimization occurs. This is intended to facilitate researchers who might otherwise not have an easy implementation available to design and test hypothesis regarding the behavior of recurrent neural networks in different task environements.\n\nRelease announcments are posted on the [psychrnn mailing list](https://www.freelists.org/list/psychrnn) and on [GitHub](https://github.com/murraylab/PsychRNN)\n\nCode is written and upkept by: [Daniel B. Ehrlich](https://github.com/dbehrlich\u003e), [Jasmine T. Stone](https://github.com/syncrostone/), [David Brandfonbrener](https://github.com/davidbrandfonbrener), and [Alex Atanasov](https://github.com/ABAtanasov).\n\nContact: psychrnn@gmail.com \n\n## Getting Started\n\nStart with [Hello World](https://psychrnn.readthedocs.io/en/latest/notebooks/Minimal_Example.html) [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/murraylab/PsychRNN/blob/master/docs/notebooks/Minimal_Example.ipynb) to get a quick sense of what PsychRNN does. Then go through the [Simple Example](https://psychrnn.readthedocs.io/en/latest/notebooks/PerceptualDiscrimination.html) [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/murraylab/PsychRNN/blob/master/docs/notebooks/PerceptualDiscrimination.ipynb) to get a feel for how to customize PsychRNN. The rest of [Getting Started](https://psychrnn.readthedocs.io/en/quickstart.html) will help guide you through using available features, defining your own task, and even defining your own model.\n\n## Install\n\n### Dependencies\n\n- python = 2.7 or python \u003e= 3.4\n- [numpy](http://www.numpy.org/)\n- [tensorflow](https://www.tensorflow.org/) \u003e= 1.13.1\n\n- For notebook demos, [jupyter](https://jupyter.org/)\n- For notebook demos, [ipython](https://ipython.org/)\n- For plotting features, [matplotlib](https://matplotlib.org/)\n\nPsychRNN was developed to work with both Python 2.7 and 3.4+ using TensorFlow 1.13.1+. It is currently being tested on Python 2.7 and 3.4-3.8 with TensorFlow 1.13.1-2.2.\n\n**Note:** TensorFlow 2.2 does not support Python \u003c 3.5. Only TensorFlow 1.13.1-1.14 are compatible with Python 3.4. Python 3.8 is only supported by TensorFlow 2.2.\n\n### Installation\n\nNormally, you can install with:\n\n\tpip install psychrnn\n\nAlternatively, you can download and extract the source files from the [GitHub release](https://github.com/murraylab/psychrnn/releases/). Within the downloaded PsychRNN folder, run:\n\n        python setup.py install\n\n[THIS OPTION IS NOT RECOMMENDED FOR MOST USERS] To get the most recent (not necessarily stable) version from the github repo, clone the repository and install:\n\n        git clone https://github.com/murraylab/PsychRNN.git\n        cd PsychRNN\n        python setup.py install\n\n## Contributing\n\nPlease report bugs to https://github.com/murraylab/psychrnn/issues.  This\nincludes any problems with the documentation.  Fixes (in the form of\npull requests) for bugs are greatly appreciated.\n\nFeature requests are welcome but may or may not be accepted due to limited\nresources. If you implement the feature yourself we are open\nto accepting it in PsychRNN.  If you implement a new feature in PsychRNN,\nplease do the following before submitting a pull request on GitHub:\n\n- Make sure your code is clean and well commented\n- If appropriate, update the official documentation in the ``docs/``\n  directory\n- Write unit tests and optionally integration tests for your new\n  feature in the ``tests/`` folder.\n- Ensure all existing tests pass (``pytest`` returns without\n  error)\n\nFor all other questions or comments, contact psychrnn@gmail.com.\n\n## License\n\nAll code is available under the MIT license. See LICENSE for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmurraylab%2Fpsychrnn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmurraylab%2Fpsychrnn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmurraylab%2Fpsychrnn/lists"}