chatvat 0.1.0__tar.gz

chatvat-0.1.0/LICENSE

@@ -0,0 +1,17 @@
+Copyright (c) 2025 Madhav Kapila
+
+All Rights Reserved.
+
+NOTICE:  All information contained herein is, and remains the property of Madhav Kapila. 
+The intellectual and technical concepts contained herein are proprietary to Madhav Kapila 
+and may be covered by Indian and Foreign Patents, patents in process, and are protected 
+by trade secret or copyright law. 
+
+Dissemination of this information or reproduction of this material is strictly forbidden 
+unless prior written permission is obtained from Madhav Kapila.
+
+Access to the source code contained herein is hereby granted to anyone to use strictly 
+for educational or private testing purposes. You may not copy, modify, distribute, 
+sell, or lease any part of our services or included software, nor may you reverse 
+engineer or attempt to extract the source code of that software, unless you have 
+written permission.

chatvat-0.1.0/PKG-INFO

@@ -0,0 +1,235 @@
+Metadata-Version: 2.3
+Name: chatvat
+Version: 0.1.0
+Summary: The Universal RAG Chatbot Factory. Zero-dependency AI deployments.
+License: Proprietary
+Author: Madhav Kapila
+Author-email: smartatk04@gmail.com
+Requires-Python: >=3.11,<4.0
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Dist: beautifulsoup4 (>=4.12.0,<5.0.0)
+Requires-Dist: chromadb (>=0.5.0,<0.6.0)
+Requires-Dist: crawl4ai (>=0.4.0,<0.5.0)
+Requires-Dist: fastapi (>=0.109.0,<0.110.0)
+Requires-Dist: langchain (>=0.3.0,<0.4.0)
+Requires-Dist: langchain-chroma (>=0.2.0,<0.3.0)
+Requires-Dist: langchain-community (>=0.3.0,<0.4.0)
+Requires-Dist: langchain-groq (>=0.2.0,<0.3.0)
+Requires-Dist: langchain-huggingface (>=0.1.0,<0.2.0)
+Requires-Dist: langchain-openai (>=0.2.0,<0.3.0)
+Requires-Dist: openai (>=1.10.0,<2.0.0)
+Requires-Dist: playwright (>=1.40.0,<2.0.0)
+Requires-Dist: pydantic (>=2.0.0,<3.0.0)
+Requires-Dist: pyfiglet (>=1.0.2,<2.0.0)
+Requires-Dist: pypdf (>=4.0.0,<5.0.0)
+Requires-Dist: python-dotenv (>=1.0.0,<2.0.0)
+Requires-Dist: requests (>=2.31.0,<3.0.0)
+Requires-Dist: rich (>=13.7.0,<14.0.0)
+Requires-Dist: tiktoken (>=0.7.0,<0.8.0)
+Requires-Dist: typer[all] (>=0.12.3,<0.13.0)
+Requires-Dist: uvicorn[standard] (>=0.27.0,<0.28.0)
+Project-URL: Homepage, https://github.com/madhavkapila
+Project-URL: Repository, https://github.com/madhavkapila/ChatVat.git
+Description-Content-Type: text/markdown
+
+# ChatVat 🏭
+> **The Universal RAG Chatbot Factory**
+
+[![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red.svg)](#license)
+[![Python](https://img.shields.io/badge/Python-3.11%2B-blue.svg)](https://www.python.org/)
+[![Docker](https://img.shields.io/badge/Docker-Ready-2496ED?logo=docker&logoColor=white)](https://www.docker.com/)
+[![Style](https://img.shields.io/badge/Code%20Style-Black-000000.svg)](https://github.com/psf/black)
+
+---
+
+## 🌟 The Vision
+
+**ChatVat** is not just another chatbot script. It is a **Manufacturing Plant** for self-contained AI systems. 
+
+It solves the "It works on my machine" problem by adhering to a strict **"Zero-Dependency"** philosophy. ChatVat takes your raw data sources—websites, APIs, and documents—and fuses them with a production-grade RAG engine into a sealed Docker container. This "capsule" contains everything needed to run: the code, the database, the browser, and the API server.
+
+You can deploy a ChatVat bot anywhere: from a MacBook Air to an air-gapped server in Antarctica, without installing Python or git.
+
+### Core Philosophy
+* **Production Parity:** The bot you test locally is bit-for-bit identical to the bot you deploy.
+* **Source Injection:** The engine code is "injected" directly into the container during the build. No external git clones or PyPI downloads are required inside the image.
+* **Self-Healing:** Built-in deduplication (MD5 Hashing), crash recovery, and "Ghost Entry" prevention.
+
+---
+
+## ⚡ Quick Start
+
+### 1. Installation
+Install the ChatVat CLI from the source (or your private registry).
+
+```bash
+pip install chatvat
+```
+
+### 2. Initialize the Assembly Line
+Create a clean directory for your new bot and run the configuration wizard.
+
+```bash
+mkdir my-crypto-bot
+cd my-crypto-bot
+chatvat init
+```
+
+*The wizard will guide you through:*
+* **Naming your bot**
+* **Setting up AI Brain** (Groq Llama-3 + HuggingFace Embeddings)
+* **Connecting Data Sources** (URLs, APIs, or Local Files)
+* **Defining Deployment Ports**
+
+### 3. Build the Capsule
+Compile your configuration and the ChatVat engine into a Docker Image.
+
+```bash
+chatvat build
+```
+
+> **What happens here?** > The CLI locates the `chatvat` library on your system, copies the core engine code into a build context, injects your `chatvat.config.json`, and triggers a Docker build. The result is a sealed image containing your specific bot.
+
+### 4. Deploy Anywhere
+Run your bot using standard Docker commands. It injects your API keys at runtime for security.
+
+```bash
+# Example: Running on Port 8000
+docker run -d \
+  -p 8000:8000 \
+  --env-file .env \
+  --name crypto-bot \
+  chatvat-bot
+```
+
+---
+
+## 🧠 Architecture Deep Dive
+
+ChatVat implements a modular **RAG (Retrieval-Augmented Generation)** pipeline designed for resilience.
+
+
+### The Components
+
+| Component | Role | Description |
+| :--- | :--- | :--- |
+| **The Cortex** | Intelligence | Powered by **Groq** for ultra-fast inference using the model of your choice and **HuggingFace** for embeddings. |
+| **The Memory** | Vector Store | A persistent, thread-safe **ChromaDB** instance. It uses MD5 hashing to prevent duplicate data entry. |
+| **The Eyes** | Crawler | A headless **Chromium** browser (via Crawl4AI/Playwright) capable of reading dynamic JS-heavy websites. |
+| **The Nervous System** | Ingestor | A background worker that auto-updates knowledge every `X` minutes (configurable). |
+| **The API** | Interface | A high-performance **FastAPI** server exposing REST endpoints. |
+
+### The "Source Injection" Workflow
+
+Unlike traditional builds that `pip install` libraries from the internet, ChatVat performs **Source Injection**:
+
+1.  **Locate:** The CLI finds where `chatvat` is installed on your host machine.
+2.  **Extract:** It copies the raw Python source code of the engine.
+3.  **Inject:** It places this code into the `/app` directory of the Docker container.
+4.  **Seal:** The Dockerfile sets `PYTHONPATH=/app`, making the injected code instantly executable without installation.
+
+---
+
+## 🛠️ Configuration Guide
+
+Your bot is defined by `chatvat.config.json`. You can edit this file manually after running `init`.
+
+```json
+{
+    "bot_name": "ChatVatBot",
+    "port": 8000,
+    "refresh_interval_minutes": 60,
+    "system_prompt": "You are a helpful assistant for the .....",
+    "llm_model": "llama-3.1-70b-versatile",
+    "embedding_model": "all-MiniLM-L6-v2",
+    "sources": [
+        {
+            "type": "static_url",
+            "target": "[https://www.amazon.com/gp/bestsellers/books/ref=zg_bs_nav](https://www.amazon.com/gp/bestsellers/books/ref=zg_bs_nav)"
+        },
+        {
+            "type": "dynamic_json",
+            "target": "[https://YOUR_API_ENDPOINT](https://YOUR_API_ENDPOINT)",
+            "headers": {
+                "Authorization": "Bearer ${API_KEY}"
+            }
+        },
+        {
+            "type": "local_file",
+            "target": "./policy_docs.pdf"
+        }
+    ]
+}
+```
+
+* **`refresh_interval_minutes`**: Set to `0` to disable auto-updates.
+* **`sources`**: Supports `static_url` (Websites), `dynamic_json` (REST APIs), and `local_file` (PDF/TXT).
+* **`headers`**: Can use `${VAR_NAME}` syntax to reference environment variables from your `.env` file.
+
+---
+
+## 📚 API Reference
+
+Once the container is running, interact with it via HTTP REST API.
+
+### 1. Health Check
+Used by cloud balancers (AWS/Render) to verify the bot is alive.
+
+```bash
+GET /health
+```
+**Response:**
+```json
+{
+  "status": "healthy",
+  "version": "0.1.0"
+}
+```
+
+### 2. Chat Interface
+The main endpoint for sending queries.
+
+```bash
+POST /chat
+```
+**Payload:**
+```json
+{
+  "message": "What events are happening on Day 1?"
+}
+```
+**Response:**
+```json
+{
+  "message": "On Day 1, the opening ceremony starts at 10 AM..."
+}
+```
+
+---
+
+## ⚖️ License & Proprietary Notice
+
+**Copyright © 2025 Madhav Kapila. All Rights Reserved.**
+
+This software is **Proprietary (Closed Source)**.
+
+* **Usage:** You are granted a limited license to use this tool for educational, private testing, or internal business purposes.
+* **Restrictions:**
+    * You **MAY NOT** copy, modify, redistribute, sell, or lease any part of the `chatvat` source code.
+    * You **MAY NOT** reverse engineer or attempt to extract the source code.
+    * You **MAY NOT** upload this package to public registries (like PyPI) or public repositories (like GitHub) without prior written permission.
+
+*All intellectual property rights remain exclusively with Madhav Kapila.*
+
+---
+
+<p align="center">
+  Built with ❤️ by the <b>ChatVat Factory</b>.
+</p>

chatvat-0.1.0/README.md

@@ -0,0 +1,194 @@
+# ChatVat 🏭
+> **The Universal RAG Chatbot Factory**
+
+[![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red.svg)](#license)
+[![Python](https://img.shields.io/badge/Python-3.11%2B-blue.svg)](https://www.python.org/)
+[![Docker](https://img.shields.io/badge/Docker-Ready-2496ED?logo=docker&logoColor=white)](https://www.docker.com/)
+[![Style](https://img.shields.io/badge/Code%20Style-Black-000000.svg)](https://github.com/psf/black)
+
+---
+
+## 🌟 The Vision
+
+**ChatVat** is not just another chatbot script. It is a **Manufacturing Plant** for self-contained AI systems. 
+
+It solves the "It works on my machine" problem by adhering to a strict **"Zero-Dependency"** philosophy. ChatVat takes your raw data sources—websites, APIs, and documents—and fuses them with a production-grade RAG engine into a sealed Docker container. This "capsule" contains everything needed to run: the code, the database, the browser, and the API server.
+
+You can deploy a ChatVat bot anywhere: from a MacBook Air to an air-gapped server in Antarctica, without installing Python or git.
+
+### Core Philosophy
+* **Production Parity:** The bot you test locally is bit-for-bit identical to the bot you deploy.
+* **Source Injection:** The engine code is "injected" directly into the container during the build. No external git clones or PyPI downloads are required inside the image.
+* **Self-Healing:** Built-in deduplication (MD5 Hashing), crash recovery, and "Ghost Entry" prevention.
+
+---
+
+## ⚡ Quick Start
+
+### 1. Installation
+Install the ChatVat CLI from the source (or your private registry).
+
+```bash
+pip install chatvat
+```
+
+### 2. Initialize the Assembly Line
+Create a clean directory for your new bot and run the configuration wizard.
+
+```bash
+mkdir my-crypto-bot
+cd my-crypto-bot
+chatvat init
+```
+
+*The wizard will guide you through:*
+* **Naming your bot**
+* **Setting up AI Brain** (Groq Llama-3 + HuggingFace Embeddings)
+* **Connecting Data Sources** (URLs, APIs, or Local Files)
+* **Defining Deployment Ports**
+
+### 3. Build the Capsule
+Compile your configuration and the ChatVat engine into a Docker Image.
+
+```bash
+chatvat build
+```
+
+> **What happens here?** > The CLI locates the `chatvat` library on your system, copies the core engine code into a build context, injects your `chatvat.config.json`, and triggers a Docker build. The result is a sealed image containing your specific bot.
+
+### 4. Deploy Anywhere
+Run your bot using standard Docker commands. It injects your API keys at runtime for security.
+
+```bash
+# Example: Running on Port 8000
+docker run -d \
+  -p 8000:8000 \
+  --env-file .env \
+  --name crypto-bot \
+  chatvat-bot
+```
+
+---
+
+## 🧠 Architecture Deep Dive
+
+ChatVat implements a modular **RAG (Retrieval-Augmented Generation)** pipeline designed for resilience.
+
+
+### The Components
+
+| Component | Role | Description |
+| :--- | :--- | :--- |
+| **The Cortex** | Intelligence | Powered by **Groq** for ultra-fast inference using the model of your choice and **HuggingFace** for embeddings. |
+| **The Memory** | Vector Store | A persistent, thread-safe **ChromaDB** instance. It uses MD5 hashing to prevent duplicate data entry. |
+| **The Eyes** | Crawler | A headless **Chromium** browser (via Crawl4AI/Playwright) capable of reading dynamic JS-heavy websites. |
+| **The Nervous System** | Ingestor | A background worker that auto-updates knowledge every `X` minutes (configurable). |
+| **The API** | Interface | A high-performance **FastAPI** server exposing REST endpoints. |
+
+### The "Source Injection" Workflow
+
+Unlike traditional builds that `pip install` libraries from the internet, ChatVat performs **Source Injection**:
+
+1.  **Locate:** The CLI finds where `chatvat` is installed on your host machine.
+2.  **Extract:** It copies the raw Python source code of the engine.
+3.  **Inject:** It places this code into the `/app` directory of the Docker container.
+4.  **Seal:** The Dockerfile sets `PYTHONPATH=/app`, making the injected code instantly executable without installation.
+
+---
+
+## 🛠️ Configuration Guide
+
+Your bot is defined by `chatvat.config.json`. You can edit this file manually after running `init`.
+
+```json
+{
+    "bot_name": "ChatVatBot",
+    "port": 8000,
+    "refresh_interval_minutes": 60,
+    "system_prompt": "You are a helpful assistant for the .....",
+    "llm_model": "llama-3.1-70b-versatile",
+    "embedding_model": "all-MiniLM-L6-v2",
+    "sources": [
+        {
+            "type": "static_url",
+            "target": "[https://www.amazon.com/gp/bestsellers/books/ref=zg_bs_nav](https://www.amazon.com/gp/bestsellers/books/ref=zg_bs_nav)"
+        },
+        {
+            "type": "dynamic_json",
+            "target": "[https://YOUR_API_ENDPOINT](https://YOUR_API_ENDPOINT)",
+            "headers": {
+                "Authorization": "Bearer ${API_KEY}"
+            }
+        },
+        {
+            "type": "local_file",
+            "target": "./policy_docs.pdf"
+        }
+    ]
+}
+```
+
+* **`refresh_interval_minutes`**: Set to `0` to disable auto-updates.
+* **`sources`**: Supports `static_url` (Websites), `dynamic_json` (REST APIs), and `local_file` (PDF/TXT).
+* **`headers`**: Can use `${VAR_NAME}` syntax to reference environment variables from your `.env` file.
+
+---
+
+## 📚 API Reference
+
+Once the container is running, interact with it via HTTP REST API.
+
+### 1. Health Check
+Used by cloud balancers (AWS/Render) to verify the bot is alive.
+
+```bash
+GET /health
+```
+**Response:**
+```json
+{
+  "status": "healthy",
+  "version": "0.1.0"
+}
+```
+
+### 2. Chat Interface
+The main endpoint for sending queries.
+
+```bash
+POST /chat
+```
+**Payload:**
+```json
+{
+  "message": "What events are happening on Day 1?"
+}
+```
+**Response:**
+```json
+{
+  "message": "On Day 1, the opening ceremony starts at 10 AM..."
+}
+```
+
+---
+
+## ⚖️ License & Proprietary Notice
+
+**Copyright © 2025 Madhav Kapila. All Rights Reserved.**
+
+This software is **Proprietary (Closed Source)**.
+
+* **Usage:** You are granted a limited license to use this tool for educational, private testing, or internal business purposes.
+* **Restrictions:**
+    * You **MAY NOT** copy, modify, redistribute, sell, or lease any part of the `chatvat` source code.
+    * You **MAY NOT** reverse engineer or attempt to extract the source code.
+    * You **MAY NOT** upload this package to public registries (like PyPI) or public repositories (like GitHub) without prior written permission.
+
+*All intellectual property rights remain exclusively with Madhav Kapila.*
+
+---
+
+<p align="center">
+  Built with ❤️ by the <b>ChatVat Factory</b>.
+</p>

chatvat-0.1.0/chatvat/bot_template/.dockerignore

@@ -0,0 +1,32 @@
+# FILE: chatvat/bot_template/.dockerignore
+
+# 1. Security (Never copy secrets into the image)
+.env
+.env.*
+*.key
+*.pem
+
+# 2. Python Cache & compiled files
+__pycache__
+*.pyc
+*.pyo
+*.pyd
+.Python
+env/
+venv/
+.venv/
+pip-log.txt
+pip-delete-this-directory.txt
+
+# 3. System / IDE files
+.git
+.gitignore
+.idea/
+.vscode/
+.DS_Store
+
+# 4. Local Data (Don't overwrite production DB with local testing DB)
+data/
+chroma_db/
+
+.env

chatvat-0.1.0/chatvat/bot_template/Dockerfile

@@ -0,0 +1,55 @@
+# FILE: chatvat/bot_template/Dockerfile
+
+FROM python:3.11-slim
+
+# 1. Set Environment Variables FIRST
+ENV PYTHONUNBUFFERED=1 \
+    PYTHONDONTWRITEBYTECODE=1 \
+    PLAYWRIGHT_BROWSERS_PATH=/usr/local/share/ms-playwright
+
+# 2. Install System Dependencies (Required for Chrome to run)
+# We do this early so it's cached.
+RUN apt-get update && apt-get install -y \
+    curl \
+    build-essential \
+    libasound2 \
+    libatk-bridge2.0-0 \
+    libgtk-3-0 \
+    libnss3 \
+    libx11-xcb1 \
+    libxss1 \
+    libxtst6 \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+# 3. Install Python Dependencies (INCLUDES PLAYWRIGHT PACKAGE)
+# This MUST happen before we try to use 'python -m playwright'
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# 4. NOW Install the Browsers (The "Eyes")
+# Since pip install is done, 'python -m playwright' will now work.
+RUN mkdir -p $PLAYWRIGHT_BROWSERS_PATH && \
+    python -m playwright install --with-deps chromium && \
+    chmod -R 755 $PLAYWRIGHT_BROWSERS_PATH
+
+# 5. Inject Source Code (The "Brain")
+COPY . .
+
+# 6. Runtime Configuration
+ENV PYTHONPATH=/app
+
+# 7. Security (Non-root user)
+RUN useradd -m -u 1000 chatvat-user && \
+    mkdir -p /app/data && \
+    chown -R chatvat-user:chatvat-user /app
+
+USER chatvat-user
+EXPOSE 8000
+
+# 8. Healthcheck & Start
+HEALTHCHECK --interval=30s --timeout=5s --start-period=5s --retries=3 \
+  CMD curl -f http://localhost:8000/health || exit 1
+
+CMD ["python", "src/main.py"]

chatvat-0.1.0/chatvat/bot_template/requirements.txt

@@ -0,0 +1,50 @@
+# FILE: chatvat/bot_template/requirements.txt
+
+# This MUST be at the top. It tells pip to look for wheels in the CPU repository first.
+# Prevents downloading massive CUDA (GPU) libraries, saving ~3GB of space.
+--extra-index-url https://download.pytorch.org/whl/cpu
+torch
+torchvision
+
+# --- Core API Server ---
+# We use 'standard' to get 'uvicorn' and optimized JSON parsers automatically.
+# This replaces the need for a separate 'uvicorn' entry.
+fastapi[standard]>=0.109.0
+python-dotenv>=1.0.0
+
+# --- The "Eyes" (Crawling Engine) ---
+beautifulsoup4
+# This runs the background crawling loop inside the container.
+# We need 'crawl4ai' for the headless browser logic.
+crawl4ai>=0.4.0
+# 'playwright' is usually installed by crawl4ai, but we list it explicitily 
+# to ensure the container has the core engine ready.
+playwright>=1.40.0
+
+# --- The "Brain" (RAG & Vector DB) ---
+# We use ChromaDB for local vector storage.
+chromadb>=0.4.22
+# Specialized splitters for Markdown (better than generic text splitters).
+langchain-text-splitters>=0.0.1
+langchain-chroma>=0.1.0
+
+# --- The "Intelligence" (LLM Integration) ---
+# Specific integration for Groq (Llama-3 models).
+langchain-groq>=0.0.1
+# For generating embeddings (e.g., HuggingFace models).
+langchain-huggingface>=0.0.1
+huggingface-hub
+# Core LangChain utilities
+langchain-core>=0.1.0
+sentence-transformers
+langchain>=0.2.0
+langchain-community
+
+# --- Utilities ---
+# For robust async HTTP calls (used by our JSON loader).
+aiohttp>=3.9.0
+# For structural validation (Pydantic V2).
+pydantic>=2.5.0
+
+# For RAG source aas file reading
+pypdf>=4.0.0