Documentation

Welcome to the Kody documentation. Kody is an open-source, embeddable AI agent widget you can add to any website with a single script tag.

Agent mode with tool calling, RAG retrieval, smart page scraping, Shadow DOM isolation, three-layer guardrails, and support for any OpenAI-compatible AI backend. MIT licensed.

Get started in 5 minutes.

Getting Started

Install Kody, create your first site, and embed the widget on your page in five minutes.

Configuration

Full schema reference for every field: branding, AI provider, guardrails, knowledge, tickets, and rate limits.

Agent Tools

Enable agent mode with built-in tools (knowledge search, ticket creation) and custom HTTP tools your AI can call autonomously.

Security

Three-layer guardrails, prompt injection detection, output scrubbing, CORS origin validation, and admin authentication.

Ticket Providers

Connect Jira, GitHub Issues, Linear, email, or a custom webhook so users can create support tickets from the chat.

Knowledge Sources

Feed your assistant with inline text, FAQ pairs, URLs (auto-cached), and local files to give it expert context.

Self-Hosting

Deploy with Docker Compose, systemd, or bare Node.js. Covers nginx reverse proxy, backups, and environment variables.

Compliance

EU AI Act transparency requirements, GDPR data minimization, right to erasure, and configuration for compliance out of the box.

Quick Links

  • Dashboard — sign up and create a site using our hosted infrastructure
  • GitHub Repository — source code, issues, and contributions