README_HF_SPACES.md

metadata

title: IntegraChat
emoji: 🤖
colorFrom: blue
colorTo: purple
sdk: docker
app_port: 7860
pinned: false
license: mit

IntegraChat — Enterprise MCP Autonomous Agent Platform

IntegraChat is an enterprise-grade, multi-tenant AI platform that demonstrates the full capabilities of the Model Context Protocol (MCP) in a production-style environment.

🚀 Quick Start

This Hugging Face Space runs the complete IntegraChat stack:

• Gradio UI on port 7860 (main interface)
• FastAPI Backend on port 8000 (API endpoints)
• Unified MCP Server on port 8900 (RAG/Web/Admin tools)

✨ Features

• 🤖 Autonomous Multi-Step MCP Agents – Intelligent tool-aware agent with conversation memory
• 📚 Enhanced Knowledge Base Management – Upload documents (PDF/DOCX/TXT/MD) with AI-generated metadata
• 🔍 Optimized RAG Search – Cross-encoder re-ranking for improved accuracy
• 🛡️ Enterprise Admin Governance – Regex-based red-flag detection with LLM enhancement
• 📊 Comprehensive Analytics – Real-time visualizations and tenant-level metrics
• 🌐 Live Web Search – Google Programmable Search integration
• 🏢 Multi-Tenant Isolation – Complete tenant isolation with role-based access control

📖 Usage

1. Enter Tenant ID: Set your tenant ID in the UI (top of the page)
2. Select Role: Choose your role (viewer, editor, admin, owner) from the dropdown
3. Start Chatting: Use the Chat tab to interact with the agent
4. Ingest Documents: Upload documents in the Document Ingestion tab (requires editor+ role)
5. Manage Rules: Add admin rules in the Admin Rules tab (requires admin+ role)
6. View Analytics: Check analytics in the Admin Analytics tab

🔧 Configuration

Set these environment variables in your Hugging Face Space settings:

Required

• POSTGRESQL_URL - PostgreSQL connection string with pgvector extension
• OLLAMA_URL - Ollama server URL (or use Groq API)
• OLLAMA_MODEL - Model name (e.g., llama3.1:latest)

Optional

• SUPABASE_URL - Supabase project URL (for production storage)
• SUPABASE_SERVICE_KEY - Supabase service role key
• GOOGLE_SEARCH_API_KEY - Google Custom Search API key
• GOOGLE_SEARCH_CX_ID - Google Custom Search Engine ID
• GROQ_API_KEY - Groq API key (alternative to Ollama)
• LLM_BACKEND - ollama or groq (default: ollama)

📚 API Endpoints

The FastAPI backend is available at /api (relative to the Space URL):

• POST /api/agent/message - Main chat endpoint
• POST /api/rag/ingest-document - Ingest documents
• GET /api/rag/list - List documents
• POST /api/admin/rules - Manage admin rules
• GET /api/analytics/overview - View analytics

Full API docs available at /api/docs when the backend is running.

🏗️ Architecture

┌─────────────────┐
│   Gradio UI     │  Port 7860
│  (Main Entry)   │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  FastAPI Backend│  Port 8000
└────────┬────────┘
         │
         ├──► MCP Server (Port 8900)
         │    ├── RAG Tools
         │    ├── Web Tools
         │    └── Admin Tools
         │
         ├──► PostgreSQL (RAG)
         ├──► Supabase/SQLite (Rules & Analytics)
         └──► LLM (Ollama/Groq)

🔐 Role-Based Access Control

• viewer - Basic chat access
• editor - Can ingest documents
• admin - Can manage rules and delete documents
• owner - Full system access

📝 License

MIT License - see LICENSE file for details.

🔗 Links

• Model Context Protocol
• Full Documentation
• Backend Documentation

---

Made with ❤️ for the MCP Hackathon