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/CLI

CLI

CLI Troubleshooting

Resolve CLI errors, node version incompatibilities, permission issues, and proxy connection drops.

Overview

Troubleshoot common CLI execution issues.

Common CLI Issues & Solutions

EACCES Error on Global Install: Use npx @asiyst/cli or configure user-owned ~/.npm-global.

401 Unauthorized: Run asiyst login or verify ASIYST_API_TOKEN in your environment.

Self-Signed SSL Proxy: Set NODE_EXTRA_CA_CERTS=/path/to/ca.pem.

PreviousSlash Commands Next API Overview

On this page

Overview Common CLI Issues & Solutions

© 2026 Asiyst · Build helpful, grounded website assistants.