liforma docs

Public Experiences

The easiest integration path — no backend required.

When to use

Public experiences are the default integration path. Use them when your experience can be accessed from allowlisted web origins without per-user authentication.

  • Marketing demos and landing pages
  • Education apps with open tutors
  • Public try-before-you-buy flows
  • iframe or hosted player embeds

Integration

<script>
  import { LiformaExperience } from '@liforma/client/svelte';
<\/script>

<LiformaExperience experienceId="exp_01DEMO1SPANISHCAFE" />

Or with the web component:

<script src="https://cdn.liforma.ai/sdk/v1/client.js"><\/script>

<liforma-experience experience-id="exp_01DEMO1SPANISHCAFE"></liforma-experience>

Requirements

  1. Experience must be marked public in Liforma
  2. Your site's origin must be on the experience allowlist
  3. Browser must support required APIs (Web Speech API for voice input)

What the SDK does

  1. Reads experienceId from your component
  2. Calls POST /v1/public-sessions with the page Origin header
  3. Receives a Session Manifest
  4. Starts the runtime — no API key on your server

Security model

Experience IDs are public. Security is enforced by origin allowlists, session token scoping, and usage quotas — not by hiding the ID.

Pricing

Public sessions are metered per minute. See pricing.