Technical Requirements Guide

1. Introduction

LiveAvatar is the Skillgym feature that brings the virtual avatar users interact with during training simulations to life in real time. Through synchronized audio/video streaming, the avatar reacts, speaks, and maintains natural eye contact with the user, delivering an immersive and engaging learning experience.

To guarantee this real-time experience, LiveAvatar requires adequate hardware, software, and network resources on the end user’s workstation. This document is intended to be shared with the customer’s IT department before roll-out, so that compatibility with the company’s device fleet can be verified in advance and surprises during use can be avoided.

Proper preparation of the client environment — particularly in corporate contexts with centrally managed workstations (standard images, virtualization, corporate proxies and firewalls) — is the single most decisive factor for the quality of the LiveAvatar experience.

2. Client Workstation Hardware Requirements

3. Software Requirements

4. Network Requirements

LiveAvatar uses real-time WebRTC connections: perceived quality depends more on connection stability (jitter, packet loss, latency) than on available bandwidth alone. Shared Wi-Fi networks, mobile hotspots, and corporate networks with centralized long-distance traffic routing are the contexts in which it is most important to verify these parameters.

In addition to the audio/video channel, LiveAvatar keeps a secure WebSocket connection (wss://) open for managing session commands: this channel must also be able to pass freely through corporate proxies and firewalls, with the same precautions indicated for UDP traffic (no SSL inspection, no forced routing through alternative paths).

5. Managed Corporate Environments (Corporate IT, VDI, Firewall)

Large organizations often adopt centrally managed workstations, with standard images, virtualization, proxies, and dedicated security policies. These environments offer major advantages in terms of security and governance, but may introduce constraints that need to be verified in advance to ensure LiveAvatar works fully. We recommend sharing this section with the IT department before roll-out.

We suggest including these points in the workstation provisioning checklist for teams that will use Skillgym, in order to prevent standard corporate security configurations from introducing limitations during roll-out.

6. Domains and Ports to Allow

Domains and ports to allow in order to use Skillgym from a corporate network.

WSS (secure WebSocket) traffic must be allowed: the proxy must permit the WebSocket upgrade and must not close long-lived connections. If the network uses TLS inspection, we recommend excluding these domains.

The avatar video is streamed in real time over WebRTC by the LiveKit Cloud service. The bare minimum is TCP 443 to *.livekit.cloud and *.turn.livekit.cloud. The UDP ports are recommended for video quality. All traffic is encrypted (TLS and DTLS). Official requirements: docs.livekit.io — Corporate firewalls.

7. What Happens if the Environment Does Not Meet the Requirements

Skillgym is designed to guarantee training continuity in every case. If the user’s workstation or network does not meet the stated requirements, the system automatically applies a fallback mechanism to safeguard the experience:

• The avatar is displayed as a static image instead of real-time video, while all other components of the simulation (audio, interaction, questionnaires, final debrief) remain fully functional.
• The user is informed with a clear message indicating the estimated time before the next automatic attempt to activate LiveAvatar.
• The system automatically retries LiveAvatar activation at the next access, without requiring any manual action from the user.

This behavior ensures that the training journey is never interrupted, even in the presence of temporarily suboptimal hardware or network conditions.

8. Pre-Roll-out Preparation Checklist

We recommend that the customer’s IT department verify the following before starting the training project:

• Workstations intended for users meet the minimum hardware requirements indicated in Section 2.
• The company’s standard browser is among those supported and kept up to date (Section 3.2).
• The corporate network (office and/or remote work) meets the bandwidth, latency, and stability parameters indicated in Section 4.
• For virtualized workstations: dedicated graphics acceleration is available for the session (Section 5).
• The Skillgym domains are included in the whitelists of corporate proxies, firewalls, and web filtering systems.
• A pilot test has been carried out with a small group of users representative of the various corporate configurations (office, remote work, virtual devices) before the large-scale roll-out.