Opening ASIYST

Just a moment

asiystAsiyst/Docs

⌘K

Back to Dashboard

asiyst

ASIIYST DOCS

Developer platform

Introduction Quickstart Installation Create an Account Create a Project Connect Your Website Your First Assistant Verify Installation

What is Asiyst?Projects Assistants Avatars Knowledge Conversations Sessions AI Providers SDK CLI API Events

SDK Overview Initialization Configuration Authentication Project ID Public Key Assistant Setup Avatar Integration Conversation Integration Events Website Integration Environment Configuration Production Setup Troubleshooting

CLI Overview Installation Authentication Login Logout Status Test Validate Deploy Publish Avatar Commands Knowledge Commands Knowledge Sync Diagnostics Configuration CLI Chat Slash Commands CLI Troubleshooting

API Overview Authentication API Keys Webhooks Getting Started Projects Webhook Configuration Assistants Signature Verification Avatars Next.js App Router Receiver Guide Knowledge Delivery & Retry Policy Conversations Webhook Troubleshooting Sessions Events Usage Connections Webhooks Deployment Publishing Errors Rate Limits

Knowledge Overview Sources Documents Website GitHub URLs Collections Indexing Processing Synchronization Search Knowledge Retrieval Knowledge Settings Knowledge Troubleshooting

Avatar Overview Avatar Studio Create an Avatar Avatar Information Assign Project Assign Knowledge Avatar ID Avatar Configuration Avatar States Idle Animation Walking Animation Interaction Avatar Knowledge Connect Avatar Avatar Troubleshooting Avatar Upload Requirements

Conversation Overview Creating Conversations Conversation Sessions Messages Visitor Sessions Assistant Responses Context Knowledge-Aware Responses Conversation Events Conversation Troubleshooting

Analytics Overview Visitors Avatar Impressions Interactions Conversations Guidance Sessions Completion Rate Average Response Time Events Metrics Reporting

Project Overview Create a Project Project Settings Project ID Environment Development Production Project Configuration SDK Configuration API Configuration Project Troubleshooting

General Configuration AI Provider Models Temperature Website Settings Data Retention Notifications Security Domains Environment Variables

Security Overview API Key Security Public Keys Private Keys Authentication Sessions Allowed Domains Data Protection Secrets GitHub Access Webhook Security Production Security Best Practices

Installation Problems SDK Problems CLI Problems Authentication Problems API Problems Avatar Problems Knowledge Problems Sync Problems Connection Problems Deployment Problems Common Errors Diagnostics

CLI Command Reference API Reference SDK Reference Configuration Reference Error Reference Event Reference Environment Variables Status Codes

Documentation Dashboard GitHub Repositories Support Changelog

Docs/Avatar

Avatar

Avatar Troubleshooting

Fix black canvas errors, WebGL context loss, bone rigging glitches, and mobile rendering bugs.

Overview

Troubleshoot 3D WebGL rendering, rigging, and animation issues.

Avatar Renders as Black Box or Blank

Verify WebGL 2: Check chrome://gpu or ensure browser hardware acceleration is enabled.

Draco Decoder: Ensure CDN endpoint https://cdn.asiyst.com is accessible and not blocked by local ad blockers.

Animation Twisting or Bone Distortion

If bones twist during animation playback:

Ensure the model's resting pose is in standard T-Pose or A-Pose.

Confirm root bone name is Hips and all vertex weights are normalized ($le 1.0$).

Mobile Touch & Scrolling Conflicts

If tapping the avatar on mobile prevents page scrolling:

Ensure the SDK container uses pointer-events: none on wrapper elements and pointer-events: auto only on the interactive avatar canvas.

PreviousConnect Avatar Next Avatar Upload Requirements

On this page

Overview Avatar Renders as Black Box or Blank Animation Twisting or Bone Distortion Mobile Touch & Scrolling Conflicts

© 2026 Asiyst · Build helpful, grounded website assistants.