HOST

Host SDK

每个 host mint 限定 embed token，页面打开 JS 聊天或 iframe。host API 密钥不离开服务器。

每个 host mint 限定 embed token，页面打开 JS 聊天或 iframe。host API 密钥不离开服务器。

分步：在 PHP、Laravel、Python、Node、Ruby、Go、Java、.NET 或无框架环境中 mint embed token。

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.

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

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

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

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

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

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

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

net8.0 sveda-dotnet-sdk. ASP.NET is MapPost plus a layout. The library is usable from any HttpClient 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

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

Install the SDK

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

Match the keys

SVEDA_CLIENT_HOST_API_KEY equals SVEDA_EMBED_HOST_API_KEY.
4

POST /sveda/session

Return origin, token, expires_in.
5

Open the chat

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

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