gitwtfhub

wtf is knowledge-chatbot?

1e3pm/knowledge-chatbot — explained in plain English

Analysis updated 2026-05-18

11TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A self-hosted chatbot widget that answers questions from your website's content, built entirely on Cloudflare's serverless stack.

Mindmap

mindmap
  root((knowledge chatbot))
    What it does
      Answers from site content
      Text and voice chat
      Crawls and indexes pages
    Tech stack
      Cloudflare Workers
      Cloudflare D1
      Vectorize search
      Workers AI
    Setup
      One click deploy
      Cloudflare account needed
      Vector index config
    Use cases
      Website support bot
      Self hosted RAG
    Audience
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Add a chat widget to a website that answers visitor questions using the site's own content.

REASON 2

Deploy a self-hosted AI support bot without renting a separate backend server.

REASON 3

Offer both text and voice chat for answering common customer questions automatically.

REASON 4

Experiment with Cloudflare's Workers AI and Vectorize stack for a small RAG project.

What's in the stack?

TypeScriptCloudflare WorkersCloudflare D1Cloudflare VectorizeCloudflare KV

How it stacks up

1e3pm/knowledge-chatbotaaravmaloo/reveraaliyun/openclaw-exporter-to-langfuse
Stars111111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity3/52/54/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires a Cloudflare account and choosing the correct Vectorize index settings (768 dimensions, cosine metric) during setup.

You can use and modify this freely, but if you run a modified version as a network service, you must also release your modified source code.

Wtf does this do

Knowledge Chatbot is an open source chatbot widget you can add to your own website so that visitors can ask questions and get answers based on your site's content, either by typing or by speaking out loud. You give it your website as a knowledge source, and it crawls the pages, indexes the content, and uses that as the material it draws answers from when someone chats with it. The whole thing runs on Cloudflare's platform rather than needing a separate server you manage yourself. It uses Cloudflare Workers to run the code, Cloudflare D1 as its database, Durable Objects to keep track of ongoing state, Vectorize for the vector search that lets it find relevant pieces of your content, Workers AI to actually generate answers, Browser Rendering to crawl your site, KV for simple key-value storage, and Assets for serving files. Deployment is meant to be simple: there is a one click Deploy to Cloudflare button, and during setup you are asked to choose 768 as the dimension size and cosine as the similarity metric for the vector search index. The README is brief and the project is described as still changing quickly, with the author noting that backward compatibility between versions is not guaranteed, so anyone adopting it early should expect updates to occasionally break existing setups. It does not go into detail about pricing, limits, or how the crawling handles very large sites. The project is released under the GNU Affero General Public License version 3, a copyleft license that requires anyone who modifies the code and runs it as a network service to also release their modified source code.

Yoink these prompts

Prompt 1
Walk me through deploying Knowledge Chatbot to Cloudflare using the Deploy to Cloudflare button.
Prompt 2
Explain what Vectorize index dimensions and cosine metric mean and why I need to set them during setup.
Prompt 3
Help me point this chatbot's crawler at my website so it can index my content as a knowledge source.
Prompt 4
Show me how to embed the Knowledge Chatbot widget on my website's pages.

Frequently asked questions

wtf is knowledge-chatbot?

A self-hosted chatbot widget that answers questions from your website's content, built entirely on Cloudflare's serverless stack.

What language is knowledge-chatbot written in?

Mainly TypeScript. The stack also includes TypeScript, Cloudflare Workers, Cloudflare D1.

What license does knowledge-chatbot use?

You can use and modify this freely, but if you run a modified version as a network service, you must also release your modified source code.

How hard is knowledge-chatbot to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is knowledge-chatbot for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.