@opentiny/genui-sdk-server

A server for the OpenTiny GenUI SDK to enhance LLM return structure stream content. Provides OpenAI-compatible chat completion API with GenUI schema streaming support.

• Streaming: Returns structured JSON Schema stream for progressive UI rendering.
• OpenAI Compatible: Drop-in replacement for OpenAI chat completions API.
• Easy Integration: Programmatic API or CLI to start the server.

Usage

CLI

# Create .env file with required variables
echo "BASE_URL=https://api.openai.com/v1" > .env
echo "API_KEY=your-api-key" >> .env

# Start server (default port 3100)
npx genui-sdk-server

# Custom port
npx genui-sdk-server -p 3000

# Custom env file
npx genui-sdk-server -e .env.production

Programmatic

import { startServer, equipChatCompletions } from '@opentiny/genui-sdk-server';
import express from 'express';

// Option 1: Use startServer (includes default route /chat/completions)
startServer({
  port: 3100,
  baseURL: 'https://api.openai.com/v1',
  apiKey: 'your-api-key',
});

// Option 2: Custom Express app
const app = express();
equipChatCompletions(app, {
  route: '/api/chat',
  baseURL: 'https://api.openai.com/v1',
  apiKey: 'your-api-key',
});
app.listen(3100);

Documentation

• Server Usage Guide

API

• Server API