Documentation

Getting Started

From zero to a live AI chat widget in under two minutes.

Quick start

01

Create your account

Sign up at orion-app.opeyra.com — no credit card needed. You get 5K free credits every month.

02

Create an AI agent

Give it a name, pick an AI model (Claude, GPT-4o, or Gemini), write its system prompt, and upload knowledge.

03

Copy your embed snippet

Grab the one-line script tag from the Embed tab. Paste it before </body> on any page.

<script
  src="https://cdn.opeyra.com/orion.js"
  data-agent="your_agent_key_here"
></script>
04

Go live

Reload your page. The chat bubble appears in the bottom-right corner, ready to help your visitors.

SDK options

JavaScript / HTML script tag
↓ 
<script src="https://cdn.opeyra.com/orion.js" data-agent="KEY"></script>
React npm package
↓ 
import OrionWidget from '@opeyra/orion-react';

<OrionWidget agentKey="KEY" />
Flutter pub.dev package
↓ 
dependencies:
  orion_chat: ^1.0.0

// In your widget:
OrionChatWidget(agentKey: 'KEY')
REST API any language
↓ 
POST https://orion-api.opeyra.com/api/chat
Authorization: Bearer AGENT_API_KEY
{
  "message": "Hello!",
  "sessionId": "user_123"
}

Configuration options

data attributes 
<!-- All available options -->
<script
  src="https://cdn.opeyra.com/orion.js"
  data-agent="your_key"          // required
  data-position="bottom-right"    // bottom-left | bottom-right
  data-color="#4F46E5"           // hex color
  data-open="false"             // start open
></script>

Knowledge base

Upload docs from your dashboard under Agents → [Agent name] → Knowledge. Supported formats:

✓ PDF documents
✓ Markdown / plain text
✓ Paste raw text
✓ URL import (web scraping)