Documentation
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