{"id":37074780,"url":"https://github.com/autoresearch/sweetbean","last_synced_at":"2026-01-14T08:47:59.205Z","repository":{"id":236263886,"uuid":"566430655","full_name":"AutoResearch/sweetbean","owner":"AutoResearch","description":"A declarative programming language built in Python, designed for the synthesis of behavioral experiments","archived":false,"fork":false,"pushed_at":"2025-10-21T14:57:55.000Z","size":6920,"stargazers_count":3,"open_issues_count":7,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-18T02:39:00.933Z","etag":null,"topics":["automated-documentation","behavioral-experiments","online-behavioral-experiments","synthetic-participants"],"latest_commit_sha":null,"homepage":"https://autoresearch.github.io/sweetbean/","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/AutoResearch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-11-15T16:54:03.000Z","updated_at":"2025-10-21T14:56:33.000Z","dependencies_parsed_at":"2024-04-26T10:46:07.165Z","dependency_job_id":"72a4f225-25d3-4cf8-90bb-ad3f1d6d1d08","html_url":"https://github.com/AutoResearch/sweetbean","commit_stats":null,"previous_names":["autoresearch/sweetbean"],"tags_count":35,"template":false,"template_full_name":null,"purl":"pkg:github/AutoResearch/sweetbean","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AutoResearch%2Fsweetbean","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AutoResearch%2Fsweetbean/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AutoResearch%2Fsweetbean/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AutoResearch%2Fsweetbean/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AutoResearch","download_url":"https://codeload.github.com/AutoResearch/sweetbean/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AutoResearch%2Fsweetbean/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28414693,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T08:38:59.149Z","status":"ssl_error","status_checked_at":"2026-01-14T08:38:43.588Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["automated-documentation","behavioral-experiments","online-behavioral-experiments","synthetic-participants"],"created_at":"2026-01-14T08:47:58.484Z","updated_at":"2026-01-14T08:47:59.191Z","avatar_url":"https://github.com/AutoResearch.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![PyPI](https://img.shields.io/pypi/v/sweetbean)\n![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/autoresearch/sweetbean/test-pytest.yml)\n![PyPI - Downloads](https://img.shields.io/pypi/dm/sweetbean)\n![Link to docs](https://img.shields.io/badge/Docs-autoresearch.github.io/sweetbean-purple)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![DOI](https://joss.theoj.org/papers/10.21105/joss.07703/status.svg)](https://doi.org/10.21105/joss.07703)\n\n\n# SweetBean\n\nA declarative programming language built in Python, designed for the synthesis of behavioral experiments. It allows researchers to specify experiments once and seamlessly compile them into a [jsPsych](https://www.jspsych.org/) experiment for conducting studies with human participants or text-based simulations with synthetic participants using large-language models. \n\n## Features\n\n- **Declarative language**: Specify experiments once and compile them into a jsPsych experiment for conducting studies with **human participants** or text-based simulations with **synthetic participants** using large-language models.\n- **Python-based**: SweetBean is built in Python, making it accessible and easy to use for researchers and educators.\n\n## Integrate with other packages\n\nThis package seamlessly integrates with other packages aimed at running online behavioral experiments:\n\n- [AutoRA](https://autoresearch.github.io/autora/): For closed loop research, automatic experiment deployment, participant recruitment, and data collection.\n- [SweetPea](http://sweetpea.ai/): For experimental design.\n\nBut it can also be used as a standalone product.\n\n## Installation\n\nThe package is available on PyPI and can be installed via pip:\n\n```bash\npip install sweetbean\n```\n\n## Compatibility\n\nSweetBean is compatible with the following version of jsPsych:\n\n- **jsPsych**: `7.x`  \n\n### Dependencies\n\nSweetbean has the following dependencies that need to be installed on your system:\n\n- **Python**: `\u003e=3.9, \u003c4.0`  \n- **java**\n\nOther versions may work but are not officially supported. If you experience issues, please report them!\n\n### Python Dependencies\nThe following Python packages are required and will be installed automatically via `pip`:\n\n- `jinja2`\n- `transcrypt`\n- `pyppeteer`\n- `pillow`\n\n### jsPsych Plugins\nSweetBean **does not support all jsPsych plugins**, but new plugins are added regularly.  \nIf you need support for a specific jsPsych plugin, please open an issue **[here](https://github.com/AutoResearch/sweetbean/issues).**\n\n## Documentation\n\nYou can find examples and documentation here: https://autoresearch.github.io/sweetbean/\n\n## Issues\n\nPlease report any issues with this software or its documentation [here](https://github.com/AutoResearch/sweetbean/issues/new/choose).\n\n## Contributing\n\nWe are open to contributions to SweetBean. More information can be found [here](https://autoresearch.github.io/sweetbean/CONTRIBUTING/).\n\n## Collaborating\n\nWe are always interested in collaborating! If you like our work but need some tailoring for your specific use case, please contact [ystrittmatter@princeton.edu](mailto:ystrittmatter@princeton.edu).\n\n## Citation\n\nIf you would like to reference SweetBean in a publication, you can use the following BibTeX entry referencing the associated [publication in the Journal of Open Source Software](https://joss.theoj.org/papers/10.21105/joss.07703):\n\n```bibtex\n@article{Strittmatter2025, doi = {10.21105/joss.07703},\nauthor = {Younes Strittmatter and Sebastian Musslick},\ntitle = {SweetBean: A declarative language for behavioral experiments with human and artificial participants},\nurl = {https://doi.org/10.21105/joss.07703}, \nyear = {2025}, \npublisher = {The Open Journal}, \nvolume = {10}, \nnumber = {107}, \npages = {7703}, \njournal = {Journal of Open Source Software},\ndoi = {10.21105/joss.07703}\n}\n```\n\n## About\n\nThis project is in active development by\nthe [Autonomous Empirical Research Group](https://musslick.github.io/AER_website/Research.html), Lead\nDesigner [Younes Strittmatter](https://younesstrittmatter.github.io/), led\nby [Sebastian Musslick](https://smusslick.com).\n\nThis research program was supported by Schmidt Science Fellows, in partnership with the Rhodes Trust, as well as the\nCarney BRAINSTORM program at Brown University.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fautoresearch%2Fsweetbean","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fautoresearch%2Fsweetbean","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fautoresearch%2Fsweetbean/lists"}