Web AI SDK & Backend Ecosystem 🤖

🚀 Integrate a professional, aesthetic AI assistant widget into any website with just one line of code.

A full-stack, open-source solution powered by a high-performance Go backend, a lightweight Shadow DOM-based frontend SDK, and a professional management console.

---

📂 Project Structure

.
├── web-ai-sdk/          # Frontend SDK (TypeScript + Preact)
│   └── Integratable chat widget with multiple skin presets.
├── web-ai-sdk-backend/  # Backend Service (Go + Gin + Eino)
│   └── SSE streaming, Multi-tenant RAG, and SQLite persistence.
├── web-ai-sdk-admin/    # Admin Console (Vue 3 + Vite)
│   └── GUI for managing tenants, agents, and knowledge bases.
└── website/             # Official Website (Vite + Tailwind)
    └── Landing page and product documentation.

✨ Key Features

Frontend (SDK)

• Modern Skin Presets: 6 built-in themes (Professional, Glass, Midnight, Cyberpunk, Brutalist, Minimal).
• Skin-Aware Tokens: Purely programmatic theming. Set one primaryColor and the SDK generates all shadows, glows, and contrast adjustments automatically.
• Shadow DOM Isolation: Zero CSS pollution. Compatible with any website infrastructure, from legacy portals to modern SPAs.
• Custom Mounting: Supports mounting to specific DOM containers with automatic absolute/fixed positioning logic.
• Premium UX: Smooth "Thinking chains" visualization (optimized for DeepSeek-R1), auto-expanding inputs, and focus-aware UI interactions.

Backend & Management

• High-Performance RAG: Built with Go and the Eino framework for efficient document retrieval and AI orchestration.
• Multi-Tenant Architecture: Manage isolated knowledge bases and configurations for multiple customers seamlessly.
• Data Sovereignty: All chat history, feedback logs, and vector data are stored locally in SQLite.
• GUI Administration: A professional dashboard to configure agent behavior, branding, and system prompts without touching code.

🚀 Quick Start

1. Backend Service (Go)

Requires Go 1.25+.

cd web-ai-sdk-backend
cp .env.example .env  # Configure your API keys
go run main.go

The service starts at http://localhost:8080.

2. Admin Console (Vue 3)

cd web-ai-sdk-admin
npm install
npm run dev

Access the dashboard to create your first tenant and get your tenantId.

🛠️ Integration Guide

1. HTML (Standard)

<script src="https://unpkg.com/@dierbei/web-ai-sdk/dist/index.umd.js"></script>
<script>
  window.WebAiSdk.init({
    tenantId: "your-tenant-id",
    apiHost: "http://localhost:8080",
  });
</script>

2. Vue 3

import { onMounted } from "vue";
import WebAiSdk from "@dierbei/web-ai-sdk";

onMounted(() => {
  WebAiSdk.init({
    tenantId: "your-tenant-id",
    apiHost: "http://localhost:8080",
  });
});

3. React

import { useEffect } from "react";
import WebAiSdk from "@dierbei/web-ai-sdk";

function MyChat() {
  useEffect(() => {
    WebAiSdk.init({
      tenantId: "your-tenant-id",
      apiHost: "http://localhost:8080",
    });
  }, []);

  return <div id="chat-container" />;
}

---

🛡️ License

Built with ❤️ by [Dierbei]. This project is open-source under the MIT license.