Frequently Asked Questions
Clear, factual answers to everything you need to know about Asiyst, 3D animated avatars, SDK/CLI installation, billing, and security.
General
What is Asiyst?
Asiyst is an AI-powered interactive website-assistant SaaS platform served at https://asiyst.com. It provides an interactive animated 3D avatar that guides visitors, answers questions, points at page elements, and navigates website interfaces in real time. It is supported by a client Web SDK, terminal CLI, multi-model AI integrations, knowledge base RAG, analytics, and platform connectors for Shopify and WordPress.
How does Knowledge Base integration work?
You can connect your website sitemap, PDF documents, Markdown files, custom URLs, and GitHub repositories. Asiyst indexes this content to ground the assistant's responses in your verified company facts, ensuring accurate, hallucination-free guidance.
What analytics and telemetry does Asiyst provide?
The dashboard provides real-time metrics on total visitor interactions, completed guidance journeys, deflection rates, token/credit consumption, and common unanswered questions so you can refine your knowledge base.
How do I contact customer or developer support?
You can submit a ticket directly via our Support Desk at https://asiyst.com/support or email our engineering team directly at support@asiyst.com.
Avatar & Guidance
How does the interactive 3D avatar work on a website?
The avatar runs in the browser via an optimized, lightweight canvas engine embedded through our Web SDK or plugin. It responds to visitor questions with natural dialogue, dynamically gestures, walks across the screen, points to relevant user interface buttons or links, and can guide visitors directly to specific product pages or sections.
Can I customize the avatar appearance, speech, and rules?
Yes. In the Asiyst Avatar Studio, you can configure the avatar's visual style, personality tone, system instructions, positioning, trigger conditions, and custom guidance paths tailored to specific URLs on your site.
Installation & SDK
How do I install the Asiyst Web SDK?
You can install the SDK by adding a lightweight script tag to your HTML header, or by importing the client package in your React, Next.js, Vue, or vanilla JavaScript application. Once configured with your public project key, the assistant initializes asynchronously without blocking page rendering.
How does the Asiyst CLI connect and configure projects?
The Asiyst CLI allows developers to manage projects, configure assistant behavior, synchronize knowledge files, and test avatar rules directly from the terminal. You authenticate securely via browser passkey/session challenge, eliminating the need to manually copy secrets into your terminal.
Which platforms and CMSs are supported?
Asiyst supports any custom web application (React, Next.js, Vue, Angular, Svelte, HTML5), native Shopify storefronts through our dedicated Shopify app, and WordPress/WooCommerce websites via our official WordPress plugin.
Does the 3D avatar slow down my website or affect Core Web Vitals?
No. The Asiyst SDK is designed for zero render blocking. Avatar assets and 3D meshes are loaded asynchronously after primary page content is interactive, ensuring your Largest Contentful Paint (LCP) and Cumulative Layout Shift (CLS) scores remain unaffected.
Billing & Credits
How do AI Credits and the USD Wallet work?
Asiyst uses an authoritative credit system where $1.00 USD equals 1,000 AI Credits. When using our managed Asiyst AI engine, requests consume credits according to actual token usage. You can fund your account by purchasing credit packages starting at $5.00 (5,000 credits) or by maintaining a USD balance in your wallet.
Is there a free trial or free credits upon signup?
Yes. Every new account receives a Free Credit Grant of 1,000 AI Credits upon project setup, allowing you to test, connect your website, and run assistant interactions without entering credit card information upfront.
Can I bring my own AI provider API keys (BYOK)?
Yes. Asiyst supports Bring Your Own Key (BYOK) mode. In BYOK mode, AI queries are routed directly through your configured OpenAI, Anthropic, or Google API credentials, and 0 Asiyst AI credits are charged for model token usage.
Security & Data
What data can the avatar and AI engine access on my website?
The assistant only accesses the DOM elements and content you explicitly configure or expose on public pages, along with knowledge documents you connect in your dashboard. It never scans private user data, cookies, or hidden browser storage.
How does Asiyst protect data security and privacy?
Asiyst uses AES-256 encryption at rest, TLS 1.3 in transit, strict Supabase Row-Level Security (RLS) policies per project, HMAC-signed webhook deliveries, and complies with GDPR/CCPA data processing standards.
Still have questions?
Our engineering and customer support team is here to assist with custom integrations, architecture reviews, and onboarding.