An open-source, plug-and-play, embeddable AI assistant that turns a static portfolio into a guided, evidence-based conversation.

Kenalin answers visitor questions about a site owner — who they are, what they've built, what expertise is relevant — always backed by curated public evidence, and routes meaningful intent (hiring, business opportunity) to a human via configured channels (WhatsApp, email, calendar, webhook). One <script> tag. One config file. No database required for a fresh install.

• Evidence-first — every claim about the owner is grounded in curated public knowledge with source links; no evidence → it says so, it never fabricates.
• Guided, not open-ended — infers intent per turn and routes toward a useful next action (portfolio discovery, hiring, light lead qualification, human handoff).
• Plug-and-play — configure behavior in kenalin.config.ts; embed one script. No core edits, no backend team, one API key (Gemini free tier covers the MVP).
• Self-hosted & portable — core runs in any JS runtime; server deploys to Node, Vercel, or Workers. Your data stays in your infrastructure.

• Not a generic ChatGPT/customer-service widget, and never impersonates the owner.
• Not an autonomous sales agent, CRM, or multi-tenant SaaS — the webhook is the boundary.
• Never states prices, claims availability, or invents URLs (see safety policy).

• Node.js ≥ 20 and pnpm ≥ 11 (monorepo).
• A Google Gemini API key (chat gemini-2.5-flash + embeddings gemini-embedding-001).

git clone https://github.com/aldianriski/kenalin
cd kenalin
pnpm install
cp .env.example .env          # add your Gemini key as KENALIN_LLM_API_KEY
pnpm build

Full setup: docs/SETUP.md

<!-- one tag, anywhere on the page -->
<script src="/kenalin.js" data-api-url="https://your-site.example" defer></script>

The <kenalin-ai> Web Component mounts a Shadow-DOM-isolated assistant, themeable via CSS custom properties on the element. See the design system.

A modular pnpm monorepo with one stateless orchestration flow:

packages/core     pure TS — schemas, config, orchestrator, prompt, policies, interfaces
packages/server   Hono API, Gemini providers, local index, ingest CLI  (all I/O here)
packages/widget   Preact Web Component + <script> embed  (talks only to /api/chat)

More: Architecture · Decisions (ADRs) · Design system · PRD

Type: Inter. The full system — colors, type scale, icon set, component library, and interaction cues — lives in assets/design/guideline.png and is documented in docs/DESIGN.md.

MIT — see LICENSE.

_{Doc owner: Tech Lead · last updated: 2026-07-06 · status: current}