Documentation/Getting Started/Quick Start

Client Setup Guide

Step-by-step guide for setting up a new client with Sensei AI Assistant.

Prerequisites

Make sure you have the following installed before starting

Node.js 18+ and npm
Git
A Supabase account (free tier works)
An OpenAI API key

Installation Steps

1
Access the admin dashboard

https://sensei-ai-eight.vercel.app/admin

2
Create a new client

Admin → Clients → New Client
Enter client name and domain

3
Configure the chatbot

Admin → Clients → [Client Name] → Settings
- Set bot name and avatar
- Customize intro message
- Configure theme colors

4
Add knowledge base content

Admin → Knowledge Base → Add Source
- Enter website URL to crawl
- Or upload PDF documents

5
Get the embed code

<script 
  src="https://sensei-ai-eight.vercel.app/widget.js" 
  data-client-id="[CLIENT_ID]"
  defer>
</script>

Environment Configuration

You'll need to configure your environment variables before running the application. Edit your .env.local file with the following:

# Supabase
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key

# OpenAI
OPENAI_API_KEY=your_openai_api_key

# Application
NEXT_PUBLIC_APP_URL=https://sensei-ai-eight.vercel.app

Next Steps

Access the Admin Dashboard

Navigate to https://sensei-ai-eight.vercel.app/admin to access the admin panel

Create Your First Client

Use the admin dashboard to create a client and configure their chat widget

Deploy the Widget

Get the embed code and add it to your client's website

Common Issues

Database connection errors

Make sure your Supabase credentials are correct and the database is accessible.

OpenAI API errors

Verify your API key is valid and has sufficient credits.

Build errors

Try deleting node_modules and running npm install again.

← Introduction Installation