Stars
Forks
Watchers
Developer links
Basjoo
Support tickets that repeat the same twelve questions all week can answer themselves when Basjoo turns your website and documents into an embeddable AI support agent you host yourself. Knowledge bases are built independently of agents, fed by crawling a single page or an entire site, or by uploading PDF, Word, Excel, HTML, and text files that are parsed into searchable chunks. Visitors chat through a widget added with one script tag, in a floating bubble, inline frame, or iframe, and answers stream back with source citations so people can verify what the bot claimed. A curated question and answer index is matched before retrieval, which means correcting a wrong answer takes effect immediately without reindexing the whole collection, and a keyword fallback mode can answer matched questions with no model key at all. When a conversation needs a person, operators watching the live session wall can take over, reply with saved macros, release the chat back to the bot, or resolve it, with business hours deciding when the bot is off duty. Lead capture forms, an unanswered question queue that groups repeats into future answers, thumbs feedback rolled into analytics, and signed outbound webhooks for seven event types round out the operator side. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. MIT licensed.
Benefits
- Your Docs Become The Agent
- Crawl a page or a whole site, or upload PDFs and office documents, and Basjoo builds a searchable knowledge base whose answers cite their sources inside an embeddable chat widget.
- Corrections Land Without Reindexing
- A curated question and answer index is matched before retrieval, so fixing a wrong answer or adding a policy reply takes effect instantly, with per-pair hit counts showing usage.
- Humans Take Over Seamlessly
- Operators monitor live sessions, jump in with saved macros, release conversations back to the bot, or resolve them, while business hours and away messages manage expectations automatically.
- Analytics That Name The Fix
- Sessions, unanswered questions, handoffs, leads, and feedback rates are reported over configurable windows with deltas, and repeated unanswered questions group into a queue ready to become answers.
Features
- Independent Knowledge Bases
- Knowledge bases outlive the agents bound to them, ingest crawled pages and uploaded files, and use per-base embeddings from the bundled local container or external providers.
- Thirteen LLM Providers
- Agents connect to OpenAI, Anthropic, Google Gemini, DeepSeek, OpenRouter, xAI, Moonshot, and more through one configuration, with streaming SSE replies and source citations.
- Embeddable Chat Widget
- One script tag adds floating, inline, or iframe chat with origin whitelists, path exclusions, traffic percentages, pre-chat forms, attachments, and signed visitor identity support.
- Lead Capture Inbox
- A public origin-checked endpoint records one lead per session with contact details and page URL, managed in a console inbox with contacted tracking and session links.
- Signed Outbound Webhooks
- Seven lifecycle events are queued transactionally, signed with an HMAC SHA-256 header, and retried with backoff so slow receivers never block a chat reply.
- Docker Compose Stack
- FastAPI, React, Qdrant vectors, SQLite data, Redis rate limiting, a headless crawler container, and a local embedding container run together with no GPU and no external SaaS required.