Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

PersonaLayer/.github

Open more actions menu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
8 Commits
 
 
 
 

Repository files navigation

PersonaLayer: Profile-Informed Web Personalization

License: MIT Chrome Extension Evaluation Suite Profiles

🌟 Key Features

  • 45 UX Profiles covering visual, motor, cognitive, and behavioral needs
  • Real-time Web Adaptation via Chrome extension
  • AI-Powered Personalization using GPT-4 and other LLMs
  • Automated Evaluation Suite for accessibility testing
  • WCAG 2.2 Aligned profiles and adaptations
  • Reproducible Benchmarking without extensive user testing

🏗️ Project Structure

PersonaLayer consists of two main components:

1. PL_WebAssist (Chrome Extension)

Real-time web personalization tool that applies AI-generated adaptations based on selected UX profiles.

PL_WebAssist/
├── manifest.json         # Chrome extension configuration
├── sidepanel/           # Main control interface
├── content/             # Page adaptation scripts
├── background/          # Service worker
├── lib/                 # LLM client library
└── assets/              # 45 UX profiles

📖 PL_WebAssist Documentation

2. PL_WebEval (Evaluation Suite)

Automated testing framework for evaluating web accessibility across profiles and generating comprehensive reports.

PL_WebEval/
├── src/pl_webeval/      # Core evaluation engine
├── scripts/             # Analysis and recovery tools
├── data/                # Test cases and profiles
└── results/             # Test outputs and reports

📖 PL_WebEval Documentation

🚀 Quick Start

Option 1: Chrome Extension (For End Users)

# 1. Install PL_WebAssist extension
1. Open chrome://extensions/
2. Enable Developer mode
3. Load unpacked → select PersonaLayer_Main/PL_WebAssist
4. Get API key from openrouter.ai
5. Configure in extension side panel

📘 Extension Quick Start Guide

Option 2: Evaluation Suite (For Researchers)

# 1. Install PL_WebEval
cd PersonaLayer_Main/PL_WebEval
pip install -e .

# 2. Set API key
export OPENROUTER_API_KEY="sk-or-..."

# 3. Run evaluation
python run_evaluation.py --testcases data/test_cases.csv

📘 Evaluation Setup Guide

📊 The 45 UX Profiles

Our profiles are organized into 8 categories:

Category Count Examples
🔍 Visual Accessibility 5 Low Vision, Color Blindness, Photophobia
🖱️ Motor & Navigation 4 Reduced Dexterity, Keyboard-Only
🧠 Cognitive & Neurodivergent 10 ADHD, Dyslexia, High Cognitive Load
🎯 Personalization-Oriented 8 Minimalist, Power User, Speed Prioritizer
🧠 Behavioral & Emotional 13 Anxious User, Impatient User, Explorer
🔊 Hearing & Media 2 Visual Notifications, Captions
🤖 Input Style 1 Voice-Only User
🛡️ General Safety 2 No Autoplay, Seizure-Safe

📖 Complete Profile Documentation

💻 System Architecture

graph TD
    A[User] -->|Selects Profile| B[PL_WebAssist Extension]
    B -->|Captures Page| C[Screenshot + HTML]
    C -->|Sends to| D[LLM API]
    D -->|Generates| E[CSS/JS Adaptations]
    E -->|Applies to| F[Web Page]
    
    G[Researcher] -->|Configures| H[PL_WebEval Suite]
    H -->|Tests| I[Multiple Websites]
    I -->|With| J[45 Profiles × N Models]
    J -->|Generates| K[Reports & Metrics]
Loading

📈 Performance & Results

Evaluation Metrics

  • Accessibility Score: 0-100 WCAG compliance rating
  • Adaptation Effectiveness: 0-2 scale (none/partial/significant)
  • Visual Complexity: Reduced by average 35%
  • Cognitive Load: Decreased for 89% of tested profiles

Cost Analysis

Component Model Cost/Page Monthly (100 pages/day)
WebAssist GPT-4o ~$0.005 ~$15
WebAssist GPT-4o-mini ~$0.0002 ~$0.60
WebEval GPT-4o (full) ~$0.10 ~$300

🔬 Research Applications

PersonaLayer enables:

  • Accessibility Research: Automated testing across diverse user needs
  • UX Studies: Profile-based user experience evaluation
  • WCAG Compliance: Systematic compliance testing
  • AI Personalization: Exploring LLM capabilities for accessibility

🛠️ Technical Stack

  • Frontend: Chrome Extension APIs (Manifest V3)
  • AI/LLM: OpenRouter API (GPT-4, Claude, Gemini)
  • Evaluation: Python, Playwright, pandas
  • Analysis: matplotlib, seaborn, LaTeX
  • Automation: GitHub Actions, pytest

📚 Documentation

🤝 Contributing

We welcome contributions! See our Contributing Guide for:

  • Adding new UX profiles
  • Improving adaptation algorithms
  • Enhancing evaluation metrics
  • Bug fixes and optimizations

📝 Citation

If you use PersonaLayer in your research, please cite:

@article{XXX,
  title={xxxxx},
  author={[Authors]},
  journal={[Journal/Conference]},
  year={2025}
}

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • WCAG 2.2 Guidelines for accessibility standards
  • OpenRouter for LLM API infrastructure
  • Chrome Extension team for platform support
  • All contributors and testers

📊 Star History

Star History Chart

🔗 Links


PersonaLayer - Making the web accessible for everyone, one profile at a time.

Install Extension | Run Evaluation | Read Paper

About

PersonaLayer

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Morty Proxy This is a proxified and sanitized view of the page, visit original site.