Configuration

Opening Settings

Access VAssist configuration through the Control Panel:

Click the Settings Icon in the chat interface (gear icon)
Navigate between tabs to configure different aspects:
- AI Config: AI provider and model settings
- TTS: Text-to-speech configuration
- STT: Speech-to-text configuration
- Features: Enable/disable AI features
- UI: Interface and appearance settings

Settings are automatically saved to browser storage and persist across sessions.

UI Preferences

Auto-Load Behavior

boolean

default:"true"

Control whether the extension loads automatically on every page.

Enabled: Extension loads on all websites automatically
Disabled: Click the extension icon to manually load on each page

Available in extension mode only

Icon Style

boolean

default:"false"

Toggle between colored and monochrome icons throughout the interface.

When colored icons are enabled, restrict colors to the AI toolbar only.Other interface elements will use monochrome icons for a cleaner look.

Application Theme

Configure how VAssist adapts to different webpage backgrounds:

Adaptive Mode
Light Mode
Dark Mode

Automatically detects the page background color and adjusts the assistant’s theme for optimal contrast.

backgroundDetection: {
  mode: 'adaptive',
  sampleGridSize: 5,  // 3-10: Higher = more accurate detection
  showDebug: false
}

Sample Grid Size: Controls detection accuracy

Range: 3-10 samples
Higher values = more accurate but slightly slower
Default: 5 (recommended balance)

Force light theme with dark chat elements on light backgrounds.

backgroundDetection: {
  mode: 'light'
}

Best for websites with predominantly white/light backgrounds.

Force dark theme with light chat elements on dark backgrounds.

backgroundDetection: {
  mode: 'dark'
}

Best for websites with predominantly black/dark backgrounds.

Chat Interface

boolean

default:"false"

Enable smooth height animation for streaming AI responses.

Performance Impact: May affect performance on lower-end devices. Disable if you experience lag during responses.

Debug Options

Developer Tools

boolean

default:"false"

Show draggable debug panel with development tools.Features:

Animation testing and controls
Position/camera adjustments
Performance metrics (FPS, draw calls, mesh count)
State machine visualization
Logger category controls

Accessing Debug Panel

Enable “Developer Tools” in UI Settings
Look for the Dev Tools button (usually top-right corner)
Click and drag to reposition the button
Click to open the debug panel

Debug Panel Features

Animation Controls

Play/pause animations
Switch between animation states (IDLE, BUSY, SPEAKING, etc.)
Test emotion mappings
Preview animation transitions

Performance Monitoring

Real-time metrics:

FPS: Current frame rate
Meshes: Active mesh count
Draw Calls: Rendering performance
Particles: Physics simulation load

Logger Controls

Enable/disable logging by category:

ai - AI service operations
tts - Text-to-speech
stt - Speech-to-text
animation - Animation system
babylon - 3D rendering
storage - Data persistence
other - General operations

Search and filter log messages in real-time.

Storage Management

Storage Structure

VAssist uses IndexedDB for persistent storage across browser sessions:

// Configuration data
storageManager.config.save('aiConfig', {...})
storageManager.config.save('uiConfig', {...})
storageManager.config.save('ttsConfig', {...})
storageManager.config.save('sttConfig', {...})

// Chat history
storageManager.chat.save(chatId, {...})

// Cache with TTL
storageManager.cache.save('key', value, ttlSeconds)

Storage Categories

Config
Chat
Cache
Settings

Application configuration - AI provider settings, UI preferences, TTS/STT config

Persists across browser sessions
Validated before saving to prevent corruption
Automatically migrated on updates

Clearing Storage

Clearing storage will reset all settings and delete chat history. This action cannot be undone.

Via Browser DevTools:

Open DevTools (F12)
Go to Application tab
Find IndexedDB → VAssistDB
Right-click → Delete

Programmatic Clear (for development):

// Clear all storage (dev/testing only)
await storageManager.clearAll()

// Clear specific categories
await storageManager.config.clear()  // Reset all settings
await storageManager.chat.clear()    // Delete chat history
await storageManager.cache.clear()   // Clear cache

Storage Statistics

Check storage usage:

const stats = await storageManager.getStats()
console.log('Storage usage:', stats)
// { totalRecords: 42, sizeEstimate: '2.3 MB', ... }

Resetting to Defaults

Start Setup Wizard Again

Re-run the initial configuration wizard:

Open UI Settings tab
Click “Start Setup Wizard Again”
Confirm the action
Page reloads and setup wizard begins

This resets the setup state but preserves your existing configuration. You can reconfigure settings through the wizard.

Factory Reset

To completely reset VAssist:

Clear browser storage (see above)
Reload the page
Complete setup wizard from scratch

All chat history and custom settings will be permanently deleted.

Get Started

Features

Guides

Opening Settings

UI Preferences

Auto-Load Behavior

Icon Style

Application Theme

Chat Interface

Debug Options

Developer Tools

Accessing Debug Panel

Debug Panel Features

Storage Management

Storage Structure

Storage Categories

Clearing Storage

Storage Statistics

Resetting to Defaults

Start Setup Wizard Again

Factory Reset

​Opening Settings

​UI Preferences

​Auto-Load Behavior

​Icon Style

​Application Theme

​Chat Interface

​Debug Options

​Developer Tools

​Accessing Debug Panel

​Debug Panel Features

​Storage Management

​Storage Structure

​Storage Categories

​Clearing Storage

​Storage Statistics

​Resetting to Defaults

​Start Setup Wizard Again

​Factory Reset

Opening Settings

UI Preferences

Auto-Load Behavior

Icon Style

Application Theme

Chat Interface

Debug Options

Developer Tools

Accessing Debug Panel

Debug Panel Features

Storage Management

Storage Structure

Storage Categories

Clearing Storage

Storage Statistics

Resetting to Defaults

Start Setup Wizard Again

Factory Reset