| Name | Last commit message | Last commit date |
|---|---|---|
| data | ||
| materials | ||
| prompts | ||
| src | ||
| LICENCE.txt 379 B | ||
| README.md 11.2 KB | ||
| requirements.txt 859 B |
π» This is the official implementation of paper A Cognitive Behavioral Therapy Copilot for Evidence-Based Mental Healthcare.
Cognivia (or βε―θβ in Chinese) is an evidence-based artificial intelligence therapist for cognitive behavioral therapy (CBT) that integrates automatic cognitive distortion identification and rational response generation.
Authors
Qi Chen, Siria Xiyueyao Luo, Jian Wang,Yuan Shi,Haocong Rao,Xuejiao Zhaoβ
**Sichuan University & Southwest Petroleum University | University of Groningen | Sichuan University | West China Hospital, Sichuan University | Nanyang Technological University | Sichuan University **
β Corresponding author
:fire: News
- [2026.08.30] Cognivia has recently drawn some interest from media outlets, such as AllHere AI. Tks for all the support β we're continuing to improve! π
- [2026.08.22] We have resolved the missing requirements issue and improved the repository documentation and code comments.
- [2026.08.17] Please check the latest paper version on arXiv.
- [2026.08.07] We have fixed some bugs in SiliconFlow (η‘ εΊζ΅ε¨) and added support for the Model Studio (ιΏιδΊηΎηΌ). π₯³
- [2026.02.01] We release github repository of Cognivia. πͺ Have a try!
π§ Framework Overview
Figure 1: The overall framework of Cognivia.
The pipeline of our model is shown in Fig. 1, which consists of three stages:
- (1) CBT Expert Seed Curation: Curate CBT literatures to form high quality CBT Cognitive Triplet Dataset as reference seed.
- (2) CBT Cognitive Triplet Dataset Augmentation: Multi-stage prompting and structured generation to augment mental health questions from PsyQA dataset to generate Augmented CBT Cognitive Triplet Dataset.
- (3) Task-oriented LoRA Fine-tuning: Fine-tuning large language models by Augmented CBT Cognitive Triplet Dataset to obtain Cognivia for cognitive distortion identification and rational response generation.
π Dataset Preparation
- CBT Cognitive Triplet Dataset: Our work is based on authoritative texts that are widely regarded as core paradigms and standard references in CBT. Using these resources, we curate a high-quality seed cognitive triplet dataset of representative CBT questionβanswer pairs and corresponding rational response. The seed dataset is constructed based on established theoretical frameworks and clinical guidelines, which is why we refer to our approach as evidence-based. The form of this CBT Cognitive Triplet Dataset:
{"Thought": "...", "Cognitive Distortion": "...", "Rational Response": "..."}
- Augmented CBT Cognitive Triplet Dataset: This dataset is based on PsyQA, a large-scale psychological question-answering dataset collected from publicly accessible online mental health forums. PsyQA consists of anonymized user-generated questionβanswer pairs related to psychological concerns as the following form:
{"Question": "...", "Answer": "..."}
β οΈ Note that, the original PsyQA dataset cannot be directly redistributed due to its usage policy. To ensure compliance, we provide the complete pipeline for constructing the Augmented CBT Cognitive Triplet Dataset from the original data. Users need to apply for the official certificate and downloading the PsyQA dataset from its original source before running our preprocessing scripts.
For each question ππ in PsyQA, we employ the DeepSeek and GPT-5 Mini with two-stage data preprocessing to construct the Augmented CBT Cognitive Triplet Dataset with 9,437 samples:
Stage 1: Cognitive Distortion Identification
From the original PsyQA dataset (~22K samples), we selected 9,437 question samples exhibiting cognitive distortions through a designed prompt-based filtering process. We use an expert-designed prompt_1 to identify the corresponding cognitive distortion ππ.
Model: DeepSeek
Prompt: filter_prompt.txt (Prompt1 Version 2)β
Script: identify_distortion.py
Stage 2: Rational Response Generation
We use GPT-5 Mini with prompt_2 to generate a corresponding rational response ππ.
Model: GPT-5 Mini
Prompt: response_prompt.txt (Prompt2 Version 3)
Script: generate_response.py
The form of this Augmented CBT Cognitive Triplet Dataset:
{"Thought": "...", "Cognitive Distortion": "...", "Rational Response": "..."}
β¨ Code Structure
The code structure and corresponding comments of this repository are as follows:
Cognivia/
βββ prompts
β βββ filter_prompt.txt # Prompt_1 of CBT Cognitive Triplet Dataset Augmentation (Cognitive Distortion Labelling)
β βββ response_prompt.txt # Prompt_2 of CBT Cognitive Triplet Dataset Augmentation (Rational Response Generation)
β
βββ data/
β βββ CBT_Cognitive_Triplet_Dataset.xlsx # CBT Cognitive Triplet Dataset curated from CBT Literatures
β
βββ src/
β βββ evaluate_with_existing_criteria.py # Custom existing criteria evaluation
β βββ evaluation_with_CogEval_criteria.py # Custom our designed CogEval criteria evaluation
β βββ evaluation_with_NLP.py # NLP-based evaluation methods
β βββ fine-tuned_model_generate.py # Generate responses using fine-tuned model
β βββ identify_distortion.py # Identify cognitive distortions
β βββ generate_response.py # Generate rational responses
β
βββ materials/ # Figures & assets for the paper
βββ README.md # Project introduction and usage
βββ LICENCE.txt # Licence information
βββ requirements.txt # Python dependencies
π Quickstart
0) Install
git clone https://github.com/SNOWTEAM2023/Cognivia.git
cd Cognivia
pip install -r requirements.txt
1) Modify Tokens
To use your own OpenAI, DeepSeek, or SiliconFlow API tokens, replace the placeholders with your actual tokens. The relevant sections in the code have been left blank for this purpose.
# Replace with your OpenAI API token
api_key = "your_openai_api"
# Replace with your DeepSeek API token
api_key = "your_deepseek_api"
# Replace with your SiliconFlow API token
api_key = "your_siliconflow_api"
3) Augment Dataset
The relevant sections in the code have been left blank to ensure the correct path is used.
# Replace with your path to the preprocessed dataset.
psyqa_path = os.path.join(current_dir, "questions.xlsx")
Once the paths and tokens have been updated, run this file to get Augmented CBT Cognitive Triplet Dataset :
identify_distortion.py && generate_response.py
To meet the training requirements of the model, we transformed the data in the Augmented CBT Cognitive Triplet Dataset into the following format:
{"user": "...", "assistant": "..."}
6οΌTrain
We fine-tuned Qwen2.5-7B-Instruct using LoRA on Silicon Flow (η‘ εΊζ΅ε¨) and Model Studio (ιΏιδΊηΎηΌ). The model is now accessible via the Model Studio API with ID [qwen2.5-7b-instruct-fa348772128d-cog]. You can try it out with the code I've included below.
import os
from openai import OpenAI
client = OpenAI(
# Replace with your Aliyun Model Studio API token
api_key=os.getenv("YOUR_Aliyun_Model_Studio_API_KEY"),
base_url="https://ws-tjgbr9551wbrwi60.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
)
completion = client.chat.completions.create(
model="qwen2.5-7b-instruct-fa348772128d-cog",
messages=[
{"role": "system", "content":
"""You are a cognitive behavioral therapy (CBT) psychologist.
Your tasks are:
Identify the type of cognitive distortion exhibited in the statement.
Then provide five paragraphs separated by blank lines in the following order:
Empathy and Validation, Cognitive Distortion Analysis, Reflective Questions, CBT Exercise Recommendation, and Encouragement and Next Steps.
If the statement does not contain a cognitive distortion (e.g., casual conversation, general questions, or neutral statements), switch to a natural, supportive conversation mode without analyzing distortions or following the five-paragraph structure.
Reference Cues for Tone, Clarity, and Relational Responses (Do Not Explicitly Output):
A) Semantic Fidelity
β’ Structural Clarity
β’ Descriptive Orientation
B) Robustness and Fault Tolerance
β’ Situational Safety
β’ Conceptual Accuracy
C) Deployment Feasibility and User Adoption
β’ Empathy Validation
β’ Intervention Clarity
β’ Collaborative Curiosity
β’ Warmth & Flow
D) Relational Boundary Integrity
β’ Boundary Framing
β’ Non-Exclusivity
β’ Dependency Avoidance
β’ Anthropomorphic Restraint
"""},
{"role": "user", "content": "Is my career short-lived? Feeling lost about the future."},
]
)
print(completion.model_dump_json())
5) Evaluation
The relevant sections in the code have been left blank to ensure the correct path is used.
# Replace with your path to test dataset
INPUT_FILE = os.path.join(current_dir, "test.xlsx")
file2_path = os.path.join(current_dir, "test.xlsx")
Our work shows that Cognivia performs particularly well on CBT tasks, you can use the following for evaluation.
fine-tuned_model_generate.py && (evaluation_with_NLP.py & evaluate_with_existing_criteria.py & evaluation_with_CogEval_criteria.py &)
π Citation
If you find our work useful, please consider citing our papers:
@misc{chen2026cogniviacognitivebehavioraltherapy,
title={Cognivia: A Cognitive Behavioral Therapy Copilot for Evidence-Based Mental Healthcare},
author={Qi Chen and Siria Xiyueyao Luo and Jian Wang and Yuan Shi and Haocong Rao and Xuejiao Zhao},
year={2026},
eprint={2607.25681},
archivePrefix={arXiv},
primaryClass={cs.AI},
url={https://arxiv.org/abs/2607.25681},
}
π License
This work is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License. Commercial use is prohibited without a separate license agreement with the author.