v0.3 · MIT · self-hosted
I LIKE BIG CHATS
AND I CANNOT LIE.
Open-source AI chat for your site. Grounded in your own published content — never freestyling your pricing — with inline forms, buttons, and confirms when text alone won't cut it.
Get the embed →
$ npx sir-chats-a-lot init⎘
Sir Chats-a-Lot
online · grounded in this site
Yo. I'm Sir Chats-a-Lot — ask me anything about the widget.
Try one
01How it works
Three steps.
Five minutes.
01
Install the package
Add the React widget from npm, then mount it anywhere your app renders React.
npm install sir-chats-a-lot
02
Point Sir at your docs
Connect your published content through the Gnosys knowledge layer. Sir reads only what you publish.
sir.gnosys = "/docs/**/*.md"
03
Visitor asks, Sir answers
Grounded answers and dynamic surfaces — forms, buttons, confirms — rendered in-thread.
// no hallucinated pricing.
02Surfaces
Beyond text.
Forms. Buttons.
Confirms.
Sir doesn't just talk back. When a sentence isn't enough, he renders the UI the visitor needs — inline, in-thread, no detours to another page.
01 · BUTTONS
Action buttons
Got 2–5 paths the visitor might want? Sir renders them as tappable chips inline.
How do I install it?
Pick your setup path:
NPM packagescal initManual route
02 · FORM
Inline form
Need an email, a name, a quick brief? Sir generates the form and sends the action to your server route.
Can I get a demo?
Drop your email and I'll send it.
Get the snippet
name@yoursite.com
Submit →
03 · CONFIRM
Confirm dialog
Destructive or irreversible action coming? Sir asks first — before doing anything you'd regret.
Clear all my messages.
Heads up — this wipes the thread.
Confirm
Clear all messages?
Yes, do itCancel
03Install
Drop it in.
Done in five.
app/scal.tsx
# 1. install the package
npm install sir-chats-a-lot
# 2. mount it in your app (Next.js App Router)
import {
SirChatsALotProvider,
SirChatsALotLauncher,
SirChatsALotWidget,
} from 'sir-chats-a-lot';
import 'sir-chats-a-lot/styles';
<SirChatsALotProvider productName="My SaaS" api={api}>
<SirChatsALotLauncher />
<SirChatsALotWidget />
</SirChatsALotProvider>What to bring
- ·An LLM API key (Anthropic, OpenAI, etc.)
- ·Your published content (markdown, HTML, sitemap.xml)
What we ship
- ·The React widget
- ·A `scal init` CLI scaffold
- ·Gnosys-friendly route templates
What we don't
- ·Hosted SaaS — you own the runtime
- ·A database — knowledge is a static JSON index
04Features
Built like a brick.
01
Grounded answers
Pulls from your published content via the Gnosys knowledge layer. No bot inventing your pricing.
02
In-chat surfaces
Forms, buttons, confirm dialogs — rendered inline when text alone won’t cut it.
03
Self-hosted
BYO LLM key. Your data never touches our servers because we don’t have any.
04
MIT open source
Audit it. Fork it. Ship it. No vendor lock-in, no per-seat tax.
05
React npm package
Install the React widget from npm, wire your own server route, and ship it in your app.
06
Themeable
Token-driven theming. Match Sir to your site without writing a line of CSS.
05Use cases
Wherever
you got chat.
Sir is built for sites where the visitor's question deserves a real answer — and the answer occasionally needs a button, a form, or an "are you sure?" attached to it.
SaaS docs
Answer support, not tickets
Sir handles the "how do I…" stack out of your support inbox. Grounded in your docs. Surfaces a contact form when he genuinely doesn’t know — instead of guessing.
See case study →
E-commerce
Pre-purchase concierge
Sizing, shipping, returns — answered from your published policies. Renders product-picker buttons. Confirms with the visitor before doing anything irreversible.
See case study →
Agency / portfolio
Brief in three messages
Visitor describes a project; Sir surfaces a scoped intake form. Submission lands in your inbox while they’re still warm — no contact-page detour.
See case study →
06Changelog
Always shipping.
Full changelog →v0.3.2
Current npm
OSS core
React widget, all surfaces and blocks, custom registries, flow guardrails, theming, persistence, transcripts, and the scal init CLI.
v0.3.0
First public npm
MIT release
The generous OSS package shipped as the public core. Pro remains a separate commercial add-on.
v0.3.x
Roadmap
Next up
Streaming responses and framework-free script-tag / web-component embeds are planned, not shipped.