Web Client

Overview

The PromethistAI Web Client runs Relational Agents in a browser with no installation. It is the same client as the mobile apps, with the same home screen, agent screens and settings, reached through a URL instead of an app store.

First Launch

The first time you open the Web Client, it asks you to consent to data processing before continuing:

  • Tick I consent to the processing of my data as described in the Privacy Policy to confirm your consent and that you are of legal age to give it

  • Click Continue

Links to the Privacy Policy and Terms and Conditions are shown alongside the checkbox, and again later under Settings → About.

Getting Started

Open an Agent from the Platform

  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 in the Web Client.

Click the arrow next to Open in new Tab for Copy URL and Copy ref. See Test Your Relational Agent for details.

Open a Whole Project

From a project in the Platform, click Open Project. The project opens in the Web Client and is added to your Projects list, so you can reach it again without going back to the Platform.

Agent and Project Addresses

Agents and projects use different URL formats:

Opens URL format Example

A published agent

https://eu.promethist.ai/a/{agentRef}

https://eu.promethist.ai/a/ethan_6apc1

A specific revision

https://eu.promethist.ai/a/{agentRef}.{revision}

https://eu.promethist.ai/a/antonin_a07fk.6

A project

https://eu.promethist.ai/p/{projectRef}

https://eu.promethist.ai/p/saa_s_templates

The agent reference is the value in the Reference column of the Platform’s agent list, without the leading @. For example, @ethan_6apc1 becomes ethan_6apc1.

A URL with no revision number always opens the agent’s Published revision. Adding a number after the dot opens that specific revision instead. The numbers are shown in the Platform against each revision, for example Draft:17.

See Revisions for what each revision state means.

Replace eu with us for agents and projects hosted in the US region.

Projects and Sign-in

Click the project logo to open the Projects panel. It lists the projects you’ve added, lets you add and remove them, and shows the account you’re signed in with.

See Authentication & Projects for the full model, and Adding a Project for how to add one by reference.

Agent Detail

Opening an agent shows its visual, name, and description, along with a button to start talking and three tabs:

Description

What the agent is for, as written by whoever created it.

Insights

Scores from any user-facing evaluations the agent has enabled. See Insights.

History

Your conversation history with this agent.

An Agents section lists the other agents available to you; use the star on a card to keep one handy. The QR button opens a scanner for adding an agent by code.

Settings

Open Settings from the home screen, or from the conversation controls while talking to an agent.

The Web Client has the same settings as the mobile apps. See Settings & Troubleshooting.

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 an Insights tab on the agent screen. It shows a score card for each insight type with average, minimum, and maximum values, along with a distribution chart.

Until you sign in to that agent’s project, the tab shows Please log in to view analytics for this agent.

Learn more about Insights.

Technical Requirements

WebGPU

The Web Client renders through WebGPU. Your browser must support WebGPU and have hardware acceleration enabled.

To check your browser, open chrome://gpu in Chrome or Edge, or visit webgpureport.org in any browser. General support status across platforms can be observed in this survey.

Supported Platforms

  • Windows: desktop browsers (Chrome, Edge)

  • macOS: Chrome, Edge, or Safari

  • iOS: Safari with WebGPU support

  • Android: browsers 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.

Loading

Opening an agent downloads its 3D scene assets before the conversation can start, so the first load takes noticeably longer than a typical web page and shows a loading screen while it works.

Troubleshooting

If you encounter issues, open your browser’s developer console to diagnose them:

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

  2. Navigate to the Console tab.

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

Common issues include:

  • WebGPU unavailable or disabled in the browser

  • Microphone access blocked

  • Network connectivity problems

The message NotSupportedError: screen.orientation.lock() is not available on this device appears on desktop browsers and is harmless. It is not the cause of a failed start.