本文へスキップ
SVEDA
JA
メニュー

HOST

Host SDK

各 host がスコープ付き embed token を mintし、ページが JS チャットまたは iframe を開く。host API キーはサーバーを出ない。

No framework Embed token

Host SDK

各 host がスコープ付き embed token を mintし、ページが JS チャットまたは iframe を開く。host API キーはサーバーを出ない。

手順：PHP、Laravel、Python、Node、Ruby、Go、Java、.NET、またはフレームワークなしで embed token を mint。

No framework

A static page can open the chat. Something on your origin still has to mint the embed token — curl for local, or a tiny POST /sveda/session.

PHP

Framework-agnostic PHP. Factory::factory() → embed()->createToken(). Your page only receives origin and token.

Laravel

The package wraps sveda-ai/php-sdk, mints Sanctum MCP tokens, and exposes StartSidecarSessionController.

Python

One client. Flask, Django, and FastAPI are route wrappers. start_host_session returns origin, token, expires_in, appearance.

Node

Native fetch. startHostSession talks to the sidecar. The page still opens chat with data-sveda-open buttons.

Ruby

The gem mints embed tokens with Bearer host auth. Rails is a controller and a layout. Plain Ruby is the same HTTP call.

Go

No framework required. net/http plus the module is the host. Templates only render chat buttons when the origin is set.

Java

HttpClient transport. Spring Boot is a controller and Thymeleaf. The SDK does not need Spring.

.NET

net8.0 sveda-dotnet-sdk. ASP.NET is MapPost plus a layout. The library is usable from any HttpClient host.

Same handshake on every host

Numbered steps on each language page match this contract. Each page also has a ready Cursor prompt. Skip the SDK with no framework.

  1. 1

    Docker sidecar

    SVEDA_EMBED_ENABLED=true on ghcr.io/neresson/sveda-server plus a host API key. CORS lists the page origin so /build/sveda/sveda-chat.css and sveda-chat.js load.

  2. 2

    Install the SDK

    Or skip it. A static page plus curl or a 20-line mint route is enough.

  3. 3

    Match the keys

    SVEDA_CLIENT_HOST_API_KEY equals SVEDA_EMBED_HOST_API_KEY.

  4. 4

    POST /sveda/session

    Return origin, token, expires_in.

  5. 5

    Open the chat

    Set data-sveda-origin and data-sveda-session, then JS or iframe.

Start without a framework.

Static HTML, an iframe, or a 20-line session endpoint. Then pick a language SDK when you want typed minting.

No framework