AI Chat Widget

🇷🇺 Инструкция на русском

Drop-in AI chat widget for any website. Works with OpenAI, Claude, Gemini, GigaChat, YandexGPT, Ollama, and any OpenAI-compatible API.

Screenshots

Features

• Page Context Awareness - Bot sees the current page: URL, title, headings, content, selected text
• Universal AI Support - OpenAI, Claude, Gemini, GigaChat, YandexGPT, DeepSeek, Qwen, Ollama, OpenRouter
• One-line Integration - Just add a
  <script>
  tag
• Self-hosted - Full control over your data
• Knowledge Base - Load custom knowledge from markdown files
• Chat History - Persists across page reloads (localStorage)
• Telegram Alerts - Get notified about escalations and feedback
• Security - Rate limiting, attack detection, IP blocking
• Privacy Settings - Exclude sensitive pages from context collection
• Markdown Support - Rich text formatting in responses
• Mobile Responsive - Works on all devices

Quick Start

1. Clone and Configure

2. Run with Docker (Recommended)

3. Or Run Locally

4. Add to Your Website

That's it! The widget will appear on your website.

Configuration

AI Providers

Edit

OpenAI (default):

Claude (Anthropic):

Google Gemini (native API):

GigaChat (Sber, Russia):

Ollama (local, free):

See

Widget Options

Page Context Awareness

The bot automatically sees the current page context and can answer questions about it:

Example: User is on

Example: User selects text "Enterprise plan" and asks "Tell me more about this" — the bot knows exactly what they're referring to.

Privacy Settings

Control what page context is sent to AI:

Knowledge Base

Add markdown files to

knowledge/
  about.md      # Company info
  faq.md        # Frequently asked questions
  pricing.md    # Pricing information

The bot will use this content to answer questions.

Telegram Alerts

Get notified when users:

• Ask for human help ("I want to talk to a human")
• Report problems ("this doesn't work")
• Leave positive feedback ("thank you, great help!")
• Leave negative feedback ("this is useless")

To get your chat ID:

1. Message @userinfobot on Telegram
2. It will reply with your chat ID

API Endpoints

Architecture

ai-chat-widget/
├── backend/
│   ├── app/
│   │   ├── api/          # API endpoints
│   │   ├── services/     # Business logic
│   │   │   ├── ai_service.py      # AI provider integration
│   │   │   ├── telegram.py        # Telegram notifications
│   │   │   ├── security.py        # Rate limiting, attack detection
│   │   │   └── storage/           # Chat history storage
│   │   ├── config.py     # Configuration
│   │   └── main.py       # FastAPI app
│   ├── data/             # Chat history (json/sqlite)
│   └── .env              # Configuration
├── widget/
│   ├── widget.js         # Self-contained widget
│   └── widget.css        # Standalone CSS (optional)
├── knowledge/            # Knowledge base markdown files
├── docker-compose.yml
└── Dockerfile

Security Features

• Rate Limiting: Configurable requests per minute/hour
• Attack Detection: SQL injection, XSS, prompt injection detection
• IP Blocking: Automatic temporary bans for attackers
• Strike System: Progressive penalties for violations
• Message Validation: Length limits, content sanitization

Storage Options

JSON (default, development):

SQLite (single server):

PostgreSQL (production):

Development

Production Deployment

With Docker Compose

With systemd

Nginx Reverse Proxy

License

MIT License - see LICENSE

Contributing

Pull requests welcome! Please ensure tests pass and code is formatted.

Support

• Issues: GitHub Issues
• Telegram: @bzc_e