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 applications.

Platform Support

Supported Platforms

  • Windows – Desktop browsers (Chrome, Edge)

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

  • Android devices – With WebGPU support

  • Linux – Desktop browsers with WebGPU support

Best Effort

  • Samsung Android devices – WebGPU support on Samsung devices cannot be guaranteed. Functionality may be limited or unavailable.

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 platform 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. From Account → Projects, open the project that contains your agent.

  2. In the project sidebar, click Assets → Agents and select the agent.

  3. Click the Open in new Tab button.

  4. The agent opens in a new browser tab using the Web Client.

The same page also has a Talk with Agent button, which embeds the agent inside the Platform rather than opening the standalone Web Client. Click the arrow next to Open in new Tab for a Copy URL option to share the link. See Test Your Relational Agent for details.

Want to embed your agent into your own website? See Widget Embedding for integration instructions.

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 Open in new Tab button (e.g., @Elena).

Sign-in & Home Screen

You can sign in to the Web Client using the same authentication as the mobile apps, including SSO. Once signed in, the home screen shows your Featured agent, Recent agents, and other entry points.

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

  • Push-to-talk

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.

Insights

When an agent has at least one user-facing evaluation enabled, signed-in users see Insights directly on the agent screen. The Summary view shows score cards for each insight type, including average, minimum, and maximum values along with a distribution chart.

On the Web Client, Insights also appear automatically at the end of each conversation, so you can review how the session went without navigating away.

Learn more about Insights.

Functional Limitations

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

  • 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 (recommended for all platforms)

  • 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.

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.