Web Client

Overview

The PromethistAI Web Client provides browser-based access to Relational Agents without requiring any application installation. It serves as the quickest entry point for new users and offers a lightweight alternative to native application.

Platform Support

Preferred and Supported

  • Windows – Desktop browsers (Chrome, Edge)

  • iOS devices – Requires iOS 16 or later and Safari with WebGPU support

Not Currently Supported

  • Linux-based machines and browsers

  • Android devices

The web client requires WebGPU support. Check your browser’s compatibility before use.

When to Use the Web Client

The web client is ideal when:

  • You want to try PromethistAI without installing any software

  • You’re on a Windows desktop where no native app is available

  • You need to embed an agent experience into an existing website or application

  • You’re evaluating PromethistAI for the first time

Getting Started

Quick Access

The easiest way to access your agent in the web client:

  1. Go to Platform → Projects → Agent

  2. Click the Open URL button

  3. The agent will open directly in your browser

Manual URL Construction

If you need to embed an agent into a website or generate links programmatically, use these URL formats:

Replace {AGENT_KEY} with your agent’s unique identifier. You can find it by copying the identifier shown below the button Open URL (e.g., @Elena).

Configuration

Settings

Access settings using the top right circle button to configure:

  • 3D avatar quality

  • 3D avatar scale

  • 3D bundle branch

  • Enable/disable 3D logging

Permissions

Microphone Access

The web client requires microphone access for voice interaction. When prompted by your browser, grant microphone permission to enable voice functionality.

If you accidentally deny permission, reset it through your browser’s site settings.

Functional Limitations

The web client offers a streamlined experience with some features unavailable compared to native applications:

  • Identities – User identity management is not supported

  • No home screen – The client launches directly into agent interaction

  • No project detail screen – Project configuration and management must be done through the PromethistAI Platform

Technical Requirements

Browser Compatibility

  • Chrome – Latest version with WebGPU support

  • Edge – Latest version with WebGPU support

  • Safari – Latest version with WebGPU support (iOS 16+ or macOS)

WebGPU Requirement

The web client requires WebGPU for rendering. Ensure your browser supports WebGPU and that hardware acceleration is enabled.

To verify WebGPU availability, visit chrome://gpu (Chrome/Edge) or check your browser’s compatibility documentation. General support status for each platform can be observed in this survey.

Current Technical Limitation
Android and Linux platforms are not currently supported due to graphics rendering constraints. These platforms have a 32-byte limit on certain GPU capabilities, while our rendering system requires 64 bytes or higher.

Performance Expectations

The web client will run on any device where the native client performs acceptably, including all supported iOS devices. However, it may perform up to 50% slower compared to native applications in some cases.

Troubleshooting

If you encounter issues with the web client, use your browser’s developer console to diagnose problems:

  1. Open developer tools (typically F12 or right-click → Inspect)

  2. Navigate to the Console tab

  3. Look for error messages related to WebGPU, audio, or network connectivity

Common issues include:

  • WebGPU initialization failures

  • Microphone access blocks

  • Network connectivity problems

All of these will surface in the console output.