Skip to content

README.md

Latest commit

 

History

History
91 lines (72 loc) · 3.27 KB

README.md

File metadata and controls

91 lines (72 loc) · 3.27 KB

Aria

Adaptive Real-time Intelligent Assistant for Cognitive Accessibility

Chrome extension · 3-agent AI system · WCAG 2.1 auditor · Sub-500ms latency

What is Aria?

Aria is a Chrome extension that injects an AI-powered accessibility layer into any website. It helps users who find the web confusing — non-native English speakers, people with cognitive differences, or anyone overwhelmed by complex interfaces.

Three specialized AI agents work together:

Agent Role
Intent Agent Classifies user requests and routes to the right handler
Task Agent Plans and executes multi-step browser actions autonomously
Form Agent Maps natural language to DOM elements and fills forms via accessibility tree traversal

Features

AI-Powered

  • Conversational assistant with contextual page understanding
  • Autonomous form filling using Groq JSON mode (guaranteed structured output)
  • Voice input via Web Speech API — speak instead of type
  • 80+ idiom database with plain English translations

Accessibility Auditing

  • Real-time WCAG 2.1 audit (7 check categories) with 0-100 accessibility score
  • Detects: missing alt text, unlabeled inputs, heading hierarchy violations, contrast issues, missing lang attribute
  • Page X-Ray visualization — color-coded overlay of all interactive elements

UI Assistance

  • Spotlight/dim mode — reduces visual clutter during tasks
  • Hover Explain — plain language tooltips on interactive elements
  • Reading mode — distraction-free editorial layout
  • Customizable themes (dark, high contrast, greyscale) and fonts (including OpenDyslexic)

Metrics

  • Cognitive Journey Meter — before/after cognitive load comparison
  • Real timing metrics — actual task duration, response latency, time saved

Architecture

extension/
  features/
    chatbot.js        # Core: 3-agent system, chat UI, WCAG auditor, form fill
    dimMode.js        # Spotlight/focus mode
    hoverExplain.js   # Hover tooltips
    standardUI.js     # Accessible UI normalization
    fontChanger.js    # Font switching (serif, mono, dyslexic)
    changeColour.js   # Theme switching
    commands.js       # Quick command routing
  content.js          # Content script controller
  popup.html/js       # Extension popup UI
  demo.html           # Demo page with deliberate WCAG violations
api/
  chat.js             # Vercel serverless proxy with multi-key API rotation

Setup

1. Load the extension

  1. Go to chrome://extensions/
  2. Enable Developer mode
  3. Click Load unpacked → select the extension/ folder

2. Backend (required for AI features)

Deploy api/ to Vercel and set environment variables:

GROQ_API_KEY=gsk_...
GROQ_API_KEY_2=gsk_...   # optional, for rate limit rotation
GROQ_API_KEY_3=gsk_...   # supports up to 6 keys

Tech Stack

  • Runtime: Chrome Extension (Manifest V3)
  • AI: Groq API (Llama 3.3 70B) with JSON mode
  • Backend: Vercel Serverless Functions
  • Voice: Web Speech API (built-in, no API key)
  • Storage: Chrome Storage API (sync + local)
  • Design: WCAG AAA compliant, Instrument Sans + Atkinson Hyperlegible

License

MIT