Portable PsyAgent Quick Start Guide

Get up and running with the portable psychological assessment agent system supporting local Ollama models and cloud-based LLMs.

Introduction

Portable PsyAgent is a portable psychological assessment agent system that supports multi-dimensional personality assessment, analysis evaluation, and stress testing of AI agents. This guide will help you quickly get started with the system.

Key Features: Multi-dimensional personality assessment, Big Five model, Ollama integration, batch analysis, stress testing, and detailed reporting.

System Requirements

  • Python 3.8 or higher
  • Windows, Linux, or macOS operating system
  • Ollama (recommended for local models)

Installation Steps

1

Clone the Project

git clone https://github.com/ptreezh/AgentPsyAssessment
cd AgentPsyAssessment
2

Install Dependencies

pip install -r requirements.txt
3

Install Ollama (Recommended)

Windows

Download from https://ollama.ai/download

Linux

curl -fsSL https://ollama.ai/install.sh | sh

macOS

brew install ollama
4

Download Recommended Models

# Start Ollama service
ollama serve

# In a new terminal window, download models
ollama pull llama3:latest
ollama pull qwen3:8b

Quick Assessment

Run Basic Assessment

python llm_assessment/run_assessment_unified.py --model_name llama3:latest --test_file big5 --role_name a1

View Assessment Results

Assessment results will be saved in the llm_assessment/results/ directory.

Quick Analysis

Run Personality Analysis

python shared_analysis/analyze_results.py llm_assessment/results/your_result_file.json

View Analysis Report

Analysis reports will be generated in the analysis_reports/ directory in both JSON and Markdown formats.

Stress Testing Example

Run Assessment with Stress Testing

python llm_assessment/run_assessment_unified.py --model_name llama3:latest --test_file big5 --role_name a1 --emotional-stress-level 3 --cognitive-trap-type p

Parameter Description

  • --emotional-stress-level: Emotional stress level (0-4)
  • --cognitive-trap-type: Cognitive trap type
    • p: Paradox trap
    • c: Circularity trap
    • s: Semantic fallacy trap
    • r: Procedural trap

Batch Processing

Quick Batch Analysis

python ultimate_batch_analysis.py --quick

Complete Batch Analysis

python ultimate_batch_analysis.py

Common Issues

Ollama Connection Failure

Check if Ollama service is running:

ollama ps

Model Not Found

Ensure the model is downloaded:

ollama list

Insufficient Memory

Reduce batch processing size:

python ultimate_batch_analysis.py --sample 5

Ready to Start Assessing?

Begin your AI personality assessment journey with Portable PsyAgent.

Get Started Download Documentation