chatPsych

An open-source AI interface for Human-AI interaction research

About

chatPsych is an open-source interface for human–AI research. It leverages widespread AI models and aims to improve the quality of research in HCI/HRI by offering an easily accessible tool for novel experiments with AI systems.


The codebase offers pre/post survey programming, randomisation of AI agent conditions, and various data collection points beyond user input prompts and model token outputs.
Login Screen Chat Screen

Stimulus representativeness and psychological realism in relation to interactions with widespread AI systems is emphasised.

chatPsych offers a method for experimental designs that require prompt engineering, manipulating model hyperparameters, basic model comparison, content moderation, and more.




For usage, questions or collaborations, please cite/contact the developer:

Oliver Lack
oliver.lack@adelaide.edu.au | oliver@oliverlack.com
oliverlack.com
Researcher Profile
Australian Institute for Machine Learning (AIML) | School of Psychology
Adelaide University, Australia

Tutorial

Video tutorial pending...

Written tutorial included in upcoming research methods paper.

For workshops, custom setup, or in-depth tutorials reach out to contact in the About section.

Playground

Login
Prolific_ID = 'your name'
Password = castle

Researcher Login
Researcher_Username = admin
Researcher_Password = admin


Downloads

chatPsych is available on GitHub. It is free and open-source and we encourage community-driven improvements.

chatPsych Source Code

The repo includes end-to-end deployment instructions for non-technical researchers



License

MIT License

Copyright (c) 2025 Oliver Lack

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Adaptions


Wordie-AI

Wordie-AI demonstrates an experiment that assigns participants to AI agent files with different temperatures, models, and system messages. It implements a 'Wordgame', similar to an open-ended version of 20-questions.

Wordie-AI Codebase


False-Memory Experiment

This iteration demonstrates the use of chatPsych for research that investigates false memories and their formation through conversational agents.

False-Memory Experiment

Developers

Lead: Oliver C. Lack

Institutional Support: Australian Institute for Machine Learning & School of Psychology, University of Adelaide

We welcome collaboration and pull requests. Driving innovation through open-source practices ensures the platform grows with new AI features and research needs.


For usage, questions or collaborations, please cite and contact:

Oliver Lack
oliver.lack@adelaide.edu.au | oliver@oliverlack.com
oliverlack.com
Researcher Profile

Blog

Our blog will feature usage guides, updates on newly integrated AI models, tutorials for lab-based or online expansions, and posts highlighting researchers’ findings.

We encourage the community to contact us about adaptions, updates, and research successes.