db-chat-widget 0.1.0__tar.gz

db_chat_widget-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,28 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package with dev extras
+        run: pip install -e ".[dev]"
+
+      - name: Lint
+        run: ruff check .
+
+      - name: Test
+        run: pytest -v

db_chat_widget-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+venv/
+.env
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+*.db
+*.sqlite3
+.coverage
+htmlcov/
+.idea/
+.vscode/

db_chat_widget-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Armand Kouassi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

db_chat_widget-0.1.0/PKG-INFO

@@ -0,0 +1,233 @@
+Metadata-Version: 2.4
+Name: db-chat-widget
+Version: 0.1.0
+Summary: Embeddable chatbot widget that answers natural-language questions about your database.
+Project-URL: Homepage, https://github.com/armandkouassi/db-chat-widget
+Project-URL: Issues, https://github.com/armandkouassi/db-chat-widget/issues
+Author: Armand Kouassi
+License-Expression: MIT
+License-File: LICENSE
+Keywords: chatbot,database,llm,nl2sql,sql,widget
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Database
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Requires-Dist: anthropic>=0.34
+Requires-Dist: groq>=0.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: openai>=1.30
+Requires-Dist: psycopg2-binary>=2.9
+Requires-Dist: pymysql>=1.1
+Requires-Dist: sqlalchemy>=2.0
+Requires-Dist: sqlglot>=23.0
+Provides-Extra: dev
+Requires-Dist: fastapi>=0.110; extra == 'dev'
+Requires-Dist: httpx>=0.27; extra == 'dev'
+Requires-Dist: jinja2>=3.1; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pydantic>=2.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Requires-Dist: uvicorn>=0.29; extra == 'dev'
+Provides-Extra: server
+Requires-Dist: fastapi>=0.110; extra == 'server'
+Requires-Dist: jinja2>=3.1; extra == 'server'
+Requires-Dist: pydantic>=2.0; extra == 'server'
+Requires-Dist: uvicorn>=0.29; extra == 'server'
+Description-Content-Type: text/markdown
+
+# db-chat-widget
+
+Embeddable chatbot widget that lets end users ask natural-language questions
+about a SQL database and get back answers with the underlying query and data.
+
+- **Any SQLAlchemy-compatible database**: PostgreSQL, MySQL, SQLite, etc.
+- **Pluggable LLM backend**: Anthropic Claude, OpenAI, Groq, or a local Ollama model.
+- **Read-only by default**: generated SQL is parsed and only `SELECT`
+  statements are allowed unless you explicitly opt into write access.
+- **Embeddable widget**: a small vanilla-JS chat component you can drop into
+  any existing web page with a single `<script>` tag, backed by a FastAPI
+  server.
+
+## Install
+
+```bash
+pip install "db-chat-widget[server]"
+```
+
+This includes every LLM provider (Anthropic, OpenAI, Groq, Ollama), every
+database driver (PostgreSQL, MySQL), and the standalone FastAPI server + CLI
+`serve` command used below. Pick which provider and database to use
+afterwards, at configuration time, via `--llm-provider` / `Settings.llm_provider`
+and `--db-url` / `Settings.db_url`.
+
+If you only need the `ChatEngine` as a library — e.g. from
+[django-db-chat-widget](https://github.com/krak225/django-db-chat-widget),
+which brings its own web layer — `pip install db-chat-widget` (without
+`[server]`) skips FastAPI/uvicorn/Jinja2 entirely.
+
+## Quickstart
+
+```bash
+export DB_CHAT_LLM_API_KEY=gsk_...   # your Groq API key
+
+db-chat-widget serve \
+  --db-url "postgresql://user:pass@localhost/mydb" \
+  --llm-provider groq \
+  --port 8000
+```
+
+(`--llm-provider anthropic` / `openai` work the same way, with the matching API key.)
+
+Open http://127.0.0.1:8000 for a demo chat page, or embed the widget in your
+own site.
+
+### Popup mode (floating chat bubble)
+
+Drops a chat bubble launcher into the bottom-right corner of the page — the
+most common way to bolt this onto an existing template with zero markup
+changes. Clicking it opens/closes the chat panel.
+
+```html
+<link rel="stylesheet" href="http://127.0.0.1:8000/static/widget.css" />
+<script
+  src="http://127.0.0.1:8000/static/widget.js"
+  data-mode="bubble"
+  data-api-url="http://127.0.0.1:8000/api/chat"
+  data-title="Ask about our data"
+></script>
+```
+
+Use `data-position="bottom-left"` to anchor it to the bottom-left instead.
+
+### Inline mode
+
+Embeds the chat panel directly into an element already on the page, instead
+of floating:
+
+```html
+<link rel="stylesheet" href="http://127.0.0.1:8000/static/widget.css" />
+<div id="my-db-chat"></div>
+<script
+  src="http://127.0.0.1:8000/static/widget.js"
+  data-target="#my-db-chat"
+  data-api-url="http://127.0.0.1:8000/api/chat"
+  data-title="Ask about our data"
+></script>
+```
+
+### Programmatic API
+
+Both modes are also available from JavaScript, e.g. after dynamically
+injecting the script, or to control the popup (`.open()` / `.close()`):
+
+```html
+<script src="http://127.0.0.1:8000/static/widget.js"></script>
+<script>
+  const chat = DBChatWidget.init({
+    mode: "bubble", // or "inline" (requires `target`)
+    apiUrl: "http://127.0.0.1:8000/api/chat",
+    title: "Ask about our data",
+    position: "bottom-right", // or "bottom-left"
+  });
+  // chat.open(); chat.close(); chat.ask("How many orders today?");
+</script>
+```
+
+See [`examples/embed_example.html`](examples/embed_example.html) and
+[`examples/demo_app.py`](examples/demo_app.py) for a runnable, self-contained
+example with a seeded SQLite database.
+
+## Using it as a library
+
+```python
+from db_chat_widget import ChatEngine, Settings
+
+settings = Settings(
+    db_url="sqlite:///mydb.sqlite",
+    llm_provider="groq",
+    llm_api_key="gsk_...",
+    read_only=True,       # default: only SELECT statements are allowed
+    max_rows=200,          # cap on rows returned per query
+    allowed_tables=None,   # optionally restrict which tables can be queried
+)
+
+engine = ChatEngine(settings)
+result = engine.ask("How many orders were placed last month?")
+
+print(result.answer)
+print(result.sql)
+print(result.rows)
+```
+
+To mount just the FastAPI app (e.g. behind your own ASGI server or reverse
+proxy):
+
+```python
+from db_chat_widget.config import Settings
+from db_chat_widget.server.app import create_app
+
+app = create_app(Settings(db_url="...", llm_provider="openai", llm_api_key="..."))
+```
+
+## How it works
+
+1. The database schema (tables, columns, types, foreign keys) is introspected
+   via SQLAlchemy and sent to the configured LLM as context.
+2. The LLM is asked to translate the user's question into a single SQL
+   `SELECT` statement (or reply `CANNOT_ANSWER`).
+3. The generated SQL is parsed with `sqlglot` and rejected if it contains
+   anything other than a single read-only `SELECT` (no `INSERT`/`UPDATE`/
+   `DELETE`/`DROP`/multiple statements/disallowed tables).
+4. The query is executed with a row limit and the result, generated SQL, and
+   a short natural-language summary are returned to the widget.
+
+## Default encoding
+
+MySQL/MariaDB servers commonly default their client connection to `latin1`,
+which mangles accented characters (e.g. French text) unless the client asks
+for UTF-8 explicitly. When your `db_url` is a MySQL URL without a `charset`
+query parameter, `db-chat-widget` automatically connects with
+`charset=utf8mb4`:
+
+```
+mysql+pymysql://user:pass@localhost:3306/mydb
+# connects as:
+mysql+pymysql://user:pass@localhost:3306/mydb?charset=utf8mb4
+```
+
+If your URL already specifies a `charset` (e.g. `?charset=latin1`), it is left
+untouched. Other database backends (PostgreSQL, SQLite) already default to
+UTF-8 and are not affected.
+
+## Safety notes
+
+- `read_only=True` (the default) is enforced at the SQL-parsing level, not
+  just by prompting the model — treat it as the actual security boundary.
+- Use `allowed_tables` to scope the chatbot to specific tables (e.g. exclude
+  a `users`/`secrets` table containing sensitive columns).
+- The demo server enables permissive CORS (`*`) for convenience; pass
+  `cors_origins=[...]` (or `--cors-origin` on the CLI) to restrict this in
+  production.
+- Run the database user backing `db_url` with least-privilege, read-only
+  grants where possible, as defense in depth.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+ruff check .
+```
+
+## License
+
+MIT

db_chat_widget-0.1.0/README.md

@@ -0,0 +1,187 @@
+# db-chat-widget
+
+Embeddable chatbot widget that lets end users ask natural-language questions
+about a SQL database and get back answers with the underlying query and data.
+
+- **Any SQLAlchemy-compatible database**: PostgreSQL, MySQL, SQLite, etc.
+- **Pluggable LLM backend**: Anthropic Claude, OpenAI, Groq, or a local Ollama model.
+- **Read-only by default**: generated SQL is parsed and only `SELECT`
+  statements are allowed unless you explicitly opt into write access.
+- **Embeddable widget**: a small vanilla-JS chat component you can drop into
+  any existing web page with a single `<script>` tag, backed by a FastAPI
+  server.
+
+## Install
+
+```bash
+pip install "db-chat-widget[server]"
+```
+
+This includes every LLM provider (Anthropic, OpenAI, Groq, Ollama), every
+database driver (PostgreSQL, MySQL), and the standalone FastAPI server + CLI
+`serve` command used below. Pick which provider and database to use
+afterwards, at configuration time, via `--llm-provider` / `Settings.llm_provider`
+and `--db-url` / `Settings.db_url`.
+
+If you only need the `ChatEngine` as a library — e.g. from
+[django-db-chat-widget](https://github.com/krak225/django-db-chat-widget),
+which brings its own web layer — `pip install db-chat-widget` (without
+`[server]`) skips FastAPI/uvicorn/Jinja2 entirely.
+
+## Quickstart
+
+```bash
+export DB_CHAT_LLM_API_KEY=gsk_...   # your Groq API key
+
+db-chat-widget serve \
+  --db-url "postgresql://user:pass@localhost/mydb" \
+  --llm-provider groq \
+  --port 8000
+```
+
+(`--llm-provider anthropic` / `openai` work the same way, with the matching API key.)
+
+Open http://127.0.0.1:8000 for a demo chat page, or embed the widget in your
+own site.
+
+### Popup mode (floating chat bubble)
+
+Drops a chat bubble launcher into the bottom-right corner of the page — the
+most common way to bolt this onto an existing template with zero markup
+changes. Clicking it opens/closes the chat panel.
+
+```html
+<link rel="stylesheet" href="http://127.0.0.1:8000/static/widget.css" />
+<script
+  src="http://127.0.0.1:8000/static/widget.js"
+  data-mode="bubble"
+  data-api-url="http://127.0.0.1:8000/api/chat"
+  data-title="Ask about our data"
+></script>
+```
+
+Use `data-position="bottom-left"` to anchor it to the bottom-left instead.
+
+### Inline mode
+
+Embeds the chat panel directly into an element already on the page, instead
+of floating:
+
+```html
+<link rel="stylesheet" href="http://127.0.0.1:8000/static/widget.css" />
+<div id="my-db-chat"></div>
+<script
+  src="http://127.0.0.1:8000/static/widget.js"
+  data-target="#my-db-chat"
+  data-api-url="http://127.0.0.1:8000/api/chat"
+  data-title="Ask about our data"
+></script>
+```
+
+### Programmatic API
+
+Both modes are also available from JavaScript, e.g. after dynamically
+injecting the script, or to control the popup (`.open()` / `.close()`):
+
+```html
+<script src="http://127.0.0.1:8000/static/widget.js"></script>
+<script>
+  const chat = DBChatWidget.init({
+    mode: "bubble", // or "inline" (requires `target`)
+    apiUrl: "http://127.0.0.1:8000/api/chat",
+    title: "Ask about our data",
+    position: "bottom-right", // or "bottom-left"
+  });
+  // chat.open(); chat.close(); chat.ask("How many orders today?");
+</script>
+```
+
+See [`examples/embed_example.html`](examples/embed_example.html) and
+[`examples/demo_app.py`](examples/demo_app.py) for a runnable, self-contained
+example with a seeded SQLite database.
+
+## Using it as a library
+
+```python
+from db_chat_widget import ChatEngine, Settings
+
+settings = Settings(
+    db_url="sqlite:///mydb.sqlite",
+    llm_provider="groq",
+    llm_api_key="gsk_...",
+    read_only=True,       # default: only SELECT statements are allowed
+    max_rows=200,          # cap on rows returned per query
+    allowed_tables=None,   # optionally restrict which tables can be queried
+)
+
+engine = ChatEngine(settings)
+result = engine.ask("How many orders were placed last month?")
+
+print(result.answer)
+print(result.sql)
+print(result.rows)
+```
+
+To mount just the FastAPI app (e.g. behind your own ASGI server or reverse
+proxy):
+
+```python
+from db_chat_widget.config import Settings
+from db_chat_widget.server.app import create_app
+
+app = create_app(Settings(db_url="...", llm_provider="openai", llm_api_key="..."))
+```
+
+## How it works
+
+1. The database schema (tables, columns, types, foreign keys) is introspected
+   via SQLAlchemy and sent to the configured LLM as context.
+2. The LLM is asked to translate the user's question into a single SQL
+   `SELECT` statement (or reply `CANNOT_ANSWER`).
+3. The generated SQL is parsed with `sqlglot` and rejected if it contains
+   anything other than a single read-only `SELECT` (no `INSERT`/`UPDATE`/
+   `DELETE`/`DROP`/multiple statements/disallowed tables).
+4. The query is executed with a row limit and the result, generated SQL, and
+   a short natural-language summary are returned to the widget.
+
+## Default encoding
+
+MySQL/MariaDB servers commonly default their client connection to `latin1`,
+which mangles accented characters (e.g. French text) unless the client asks
+for UTF-8 explicitly. When your `db_url` is a MySQL URL without a `charset`
+query parameter, `db-chat-widget` automatically connects with
+`charset=utf8mb4`:
+
+```
+mysql+pymysql://user:pass@localhost:3306/mydb
+# connects as:
+mysql+pymysql://user:pass@localhost:3306/mydb?charset=utf8mb4
+```
+
+If your URL already specifies a `charset` (e.g. `?charset=latin1`), it is left
+untouched. Other database backends (PostgreSQL, SQLite) already default to
+UTF-8 and are not affected.
+
+## Safety notes
+
+- `read_only=True` (the default) is enforced at the SQL-parsing level, not
+  just by prompting the model — treat it as the actual security boundary.
+- Use `allowed_tables` to scope the chatbot to specific tables (e.g. exclude
+  a `users`/`secrets` table containing sensitive columns).
+- The demo server enables permissive CORS (`*`) for convenience; pass
+  `cors_origins=[...]` (or `--cors-origin` on the CLI) to restrict this in
+  production.
+- Run the database user backing `db_url` with least-privilege, read-only
+  grants where possible, as defense in depth.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+ruff check .
+```
+
+## License
+
+MIT

db_chat_widget-0.1.0/examples/demo_app.py

@@ -0,0 +1,78 @@
+"""Run a local demo: creates a small SQLite database and serves the chatbot.
+
+Usage:
+    export DB_CHAT_LLM_API_KEY=sk-...
+    python examples/demo_app.py
+"""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+
+from sqlalchemy import create_engine, text
+
+DB_PATH = Path(__file__).parent / "demo.db"
+
+
+def seed_database() -> str:
+    db_url = f"sqlite:///{DB_PATH}"
+    engine = create_engine(db_url)
+    with engine.begin() as conn:
+        conn.execute(text("DROP TABLE IF EXISTS customers"))
+        conn.execute(text("DROP TABLE IF EXISTS orders"))
+        conn.execute(
+            text("CREATE TABLE customers (id INTEGER PRIMARY KEY, name TEXT, country TEXT)")
+        )
+        conn.execute(
+            text(
+                "CREATE TABLE orders (id INTEGER PRIMARY KEY, customer_id INTEGER, "
+                "amount REAL, status TEXT)"
+            )
+        )
+        customers = [
+            (1, "Awa Diallo", "Senegal"),
+            (2, "Kofi Mensah", "Ghana"),
+            (3, "Amina Traore", "Cote d'Ivoire"),
+        ]
+        for row in customers:
+            conn.execute(
+                text("INSERT INTO customers (id, name, country) VALUES (:id, :name, :country)"),
+                {"id": row[0], "name": row[1], "country": row[2]},
+            )
+        orders = [
+            (1, 1, 120.0, "paid"),
+            (2, 1, 45.5, "pending"),
+            (3, 2, 300.0, "paid"),
+        ]
+        for row in orders:
+            conn.execute(
+                text(
+                    "INSERT INTO orders (id, customer_id, amount, status) "
+                    "VALUES (:id, :customer_id, :amount, :status)"
+                ),
+                {"id": row[0], "customer_id": row[1], "amount": row[2], "status": row[3]},
+            )
+    return db_url
+
+
+def main() -> None:
+    import uvicorn
+
+    from db_chat_widget.config import Settings
+    from db_chat_widget.server.app import create_app
+
+    db_url = seed_database()
+
+    settings = Settings(
+        db_url=db_url,
+        llm_provider=os.environ.get("DB_CHAT_LLM_PROVIDER", "anthropic"),
+        llm_api_key=os.environ.get("DB_CHAT_LLM_API_KEY"),
+        read_only=True,
+    )
+    app = create_app(settings)
+    uvicorn.run(app, host="127.0.0.1", port=8000)
+
+
+if __name__ == "__main__":
+    main()

db_chat_widget-0.1.0/examples/embed_example.html

@@ -0,0 +1,32 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <title>Embedding db-chat-widget</title>
+  <link rel="stylesheet" href="http://127.0.0.1:8000/static/widget.css" />
+</head>
+<body>
+  <h1>My existing website</h1>
+  <p>
+    A floating chat bubble is injected in the bottom-right corner by the
+    script below — no extra markup needed in this template.
+  </p>
+
+  <!-- Popup mode: no data-target needed, the widget builds its own
+       floating launcher button + panel and appends them to <body>. -->
+  <script src="http://127.0.0.1:8000/static/widget.js"
+          data-mode="bubble"
+          data-api-url="http://127.0.0.1:8000/api/chat"
+          data-title="Ask about our data"></script>
+
+  <!-- Alternative: inline mode, embedded directly into a page element
+       instead of floating. Swap the script above for this one:
+
+  <div id="my-db-chat"></div>
+  <script src="http://127.0.0.1:8000/static/widget.js"
+          data-target="#my-db-chat"
+          data-api-url="http://127.0.0.1:8000/api/chat"
+          data-title="Ask about our data"></script>
+  -->
+</body>
+</html>

db_chat_widget-0.1.0/pyproject.toml

@@ -0,0 +1,80 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "db-chat-widget"
+version = "0.1.0"
+description = "Embeddable chatbot widget that answers natural-language questions about your database."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+    { name = "Armand Kouassi" },
+]
+keywords = ["chatbot", "sql", "database", "llm", "nl2sql", "widget"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Database",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+dependencies = [
+    "sqlalchemy>=2.0",
+    "sqlglot>=23.0",
+    # LLM providers
+    "anthropic>=0.34",
+    "openai>=1.30",
+    "groq>=0.11",
+    "httpx>=0.27",
+    # database drivers
+    "psycopg2-binary>=2.9",
+    "pymysql>=1.1",
+]
+
+[project.optional-dependencies]
+# Only needed for the standalone FastAPI server / CLI `serve` command and the
+# embeddable demo page. Not required to use ChatEngine as a library (e.g. from
+# django-db-chat-widget, which brings its own web layer).
+server = [
+    "fastapi>=0.110",
+    "uvicorn>=0.29",
+    "pydantic>=2.0",
+    "jinja2>=3.1",
+]
+dev = [
+    "db-chat-widget[server]",
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "httpx>=0.27",
+    "ruff>=0.4",
+    "mypy>=1.10",
+]
+
+[project.urls]
+Homepage = "https://github.com/armandkouassi/db-chat-widget"
+Issues = "https://github.com/armandkouassi/db-chat-widget/issues"
+
+[project.scripts]
+db-chat-widget = "db_chat_widget.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/db_chat_widget"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]

db_chat_widget-0.1.0/src/db_chat_widget/__init__.py

@@ -0,0 +1,6 @@
+from db_chat_widget.chat.engine import ChatEngine, ChatResult
+from db_chat_widget.config import Settings
+
+__version__ = "0.1.0"
+
+__all__ = ["ChatEngine", "ChatResult", "Settings", "__version__"]