EventHive: Knowledge Chat

AI-powered chat widget that answers questions using your uploaded documents. Upload PDFs, Word docs, spreadsheets and JSON files — the widget finds relevant information using RAG and responds in plain language.

Quick Start

Browser Mode (no install)

1. Download the latest release or clone this repo
2. Open tool.html in any modern browser
3. Start using it — data saves automatically (requires EventHive hosting for full cloud sync)

Docker Mode (persistent storage)

1. Clone this repo
2. Run ./standalone/setup.sh (Mac/Linux) or standalone\setup.bat (Windows)
3. Open http://localhost:8080
4. Data saves to standalone/data/ on your machine

Also Available on EventHive

This tool is available on EventHive — the free platform for event professionals. On EventHive, your data syncs across devices, integrates with your other tools, and includes AI assistance from Erleah.

AI features in this tool are optional. They require an API key (OpenAI, Anthropic, or compatible). All core functionality works without AI.

---

Features

• Upload PDF, Word, Excel, and JSON documents
• RAG (Retrieval-Augmented Generation) pipeline
• OpenAI-compatible embeddings (OpenAI or local Ollama)
• Streaming chat responses
• Suggested questions generated from each document
• Document management admin interface
• Embeddable widget for any webpage
• Docker self-hosted version with full source code

---

Customising This Tool

This tool was built using AI-assisted development ("vibe coding"). To customise it for your needs:

1. Fork this repo (click the Fork button above)
2. Clone your fork locally
3. Read the AI Coding Docs — our methodology for building tools like this with AI
4. Open in your AI editor (Claude Code, Cursor, Copilot, etc.)
   • The .clinerules file gives your AI assistant context about this tool
   • For Claude Code: run claude and the rules load automatically
5. Modify, test, deploy — it's just HTML, CSS, and vanilla JS

Tip: The manifest.json file defines the configuration schema. If you add new configurable options, update it so your tool works with the EventHive platform's config editor.

---

Data Storage

Mode	Where	Persistence
Browser	localStorage (fallback)	Until browser data cleared
Docker	standalone/data/	On your filesystem
EventHive	Cloud database (PostgreSQL)	Synced across devices

This tool stores data in N/A — requires server. In cloud-hosted mode on EventHive, data is synced to a PostgreSQL database.

---

Related Tools

None — this is a standalone tool.

---

Contributing

PRs welcome! Please read the Contributing Guide first.

---

License

MIT — free to use, modify, and distribute.

Built by Visual Hive as part of the EventHive open-source toolkit.