Documentation
Welcome to the Kody documentation. Kody is an open-source, embeddable AI chat widget you can add to any website with a single script tag.
Built with Shadow DOM isolation, three-layer guardrails, and support for any OpenAI-compatible AI backend. ~22 KB gzipped. 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.
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.
Quick Links
- Dashboard — sign up and create a site using our hosted infrastructure
- GitHub Repository — source code, issues, and contributions