KBFox

Description

KBFox adds an AI-powered chatbot to your WordPress site, trained on your own content. Upload your documents, configure your preferred AI provider, and your visitors get accurate answers drawn directly from your knowledge base.

Chatbot Widget

A floating chat widget appears on the front end of your site. Visitors can ask questions and receive answers grounded in your uploaded documents. The widget can also be embedded anywhere using the [grayfox_chat] shortcode. No registration required for visitors.

Knowledge Base (RAG)

Upload PDFs, Word documents (.docx), plain text, CSV, and Markdown files. GrayFox summarizes each document and stores the content in a local database. When a visitor asks a question, the plugin retrieves the most relevant sections and passes them to your configured LLM — no content leaves your server until that retrieval step.

For best performance, 15–20 documents is the recommended knowledge base size.

Supported LLM Providers

OpenAI, Anthropic (Claude), Google Gemini, and Groq. You supply your own API key — GrayFox never proxies your requests through its own servers.

Privacy

Visitor chat messages and captured contact details are stored in your WordPress database. Messages are sent to the LLM provider you configure. See the Privacy Policy section for full details.

External Services

This plugin connects to external services as described below. All connections are initiated by the site administrator’s configuration — no external calls are made on plugin activation.

LLM API (user-configured)
Chat responses and document summarization are sent to the LLM API provider you choose in Settings. Visitor messages and your knowledge base content are included in these requests.
— OpenAI: https://openai.com — Terms: https://openai.com/policies/terms-of-use — Privacy: https://openai.com/policies/privacy-policy
— Anthropic: https://anthropic.com — Terms: https://www.anthropic.com/legal/consumer-terms — Privacy: https://www.anthropic.com/legal/privacy
— Google Gemini: https://ai.google.dev — Terms: https://ai.google.dev/gemini-api/terms — Privacy: https://policies.google.com/privacy
— Groq: https://groq.com — Terms: https://groq.com/terms-of-use/ — Privacy: https://groq.com/privacy-policy/

Third Party Libraries

The following libraries are distributed with this plugin:

• Action Scheduler 4.0.0 by WooCommerce — GNU General Public License v3.0 — https://github.com/woocommerce/action-scheduler
• smalot/pdfparser 2.x — GNU Lesser General Public License 3.0 — https://github.com/smalot/pdfparser
• Symfony Polyfill mbstring — MIT License — https://github.com/symfony/polyfill

Privacy Policy

KBFox collects and stores the following data from site visitors who use the chat widget:

• Visitor messages — stored in the wp_grayfox_messages table in your WordPress database.
• Session ID — a random identifier used to group messages into a conversation, stored in the visitor’s browser session.
• Visitor name and email — stored in wp_grayfox_conversations only if the visitor voluntarily provides this information during a chat.
• IP address (hashed) — used for rate limiting only; stored as a transient, not written to a permanent table.

Public KB API requests (if enabled): When the Public KB API is enabled, each inbound request is logged to the wp_grayfox_api_log table. The log includes the caller’s IP address, country code (resolved via Cloudflare header if present), user agent, query parameter, response size, and response time. This data is used solely for usage analytics visible in the GrayFox admin dashboard.

What is sent to external services: Visitor messages and relevant sections from your knowledge base are sent to the LLM API provider you configure in Settings (OpenAI, Anthropic, Google Gemini, or Groq). No visitor data is sent to GrayFox servers.

Data retention: Conversation data remains in your database until deleted. You can delete individual conversations from GrayFox > Conversations, or drop all tables by uninstalling the plugin.

Site administrators should disclose chatbot data collection to visitors in their site’s own privacy policy.

Source Code

This plugin’s JavaScript source files are minified in the distributed zip. The full source code is available at:
https://github.com/breinosa-star/wpfox-assistant-plugin