Documentation
Docs/Getting Started

Getting Started

Deploy a custom AI assistant trained on your documents in under 10 minutes. No ML expertise needed.

Step 01

Create your account

Sign up at clara.ai and choose a plan. The Free plan lets you create 1 knowledge base with up to 50 documents — no credit card required.

  • Visit /pricing and click Get Started
  • Enter your organisation name and email
  • Verify your email address
  • Log in to the admin dashboard
Step 02

Create a knowledge base

A knowledge base (KB) is a collection of documents your AI will search against. Head to the admin dashboard → Knowledge Bases → New KB.

# Or create via API
curl -X POST https://your-org.clara.ai/api/kbs \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Support Docs", "description": "Customer support knowledge"}'
  • Name your KB (e.g. 'Product Docs')
  • Upload PDFs, Word docs, or paste URLs
  • Wait for ingestion to complete (green badge)
  • Test with a sample question in the Sandbox
Step 03

Embed on your website

Drop a single <script> tag on any page. Your branded AI chat widget will appear in the bottom-right corner instantly.

<!-- Add to your HTML, before </body> -->
<script
  src="https://your-org.clara.ai/embed/widget.js"
  data-org="your-org-slug"
  data-kb="your-kb-id"
  data-theme="dark"
  defer
></script>
  • Go to Admin → Workspace → Embed
  • Copy your embed snippet
  • Paste before </body> on your site
  • Refresh and see the chat bubble appear
Step 04

Enable voice AI (optional)

Starter plan and above include real-time voice. Enable it in Admin → Workspace → Settings → Voice. Users click the mic icon to speak naturally.

<!-- Add data-voice="true" to your embed tag -->
<script
  src="https://your-org.clara.ai/embed/widget.js"
  data-org="your-org-slug"
  data-kb="your-kb-id"
  data-voice="true"
  defer
></script>
  • Upgrade to Starter or higher
  • Enable voice in Workspace Settings
  • Add data-voice="true" to your embed tag
  • Test the mic button in your chat widget