Spaces:
Sleeping
Sleeping
File size: 3,983 Bytes
916e12b |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 |
---
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](LICENSE) file for details.
## 🔗 Links
- [Model Context Protocol](https://modelcontextprotocol.io/)
- [Full Documentation](README.md)
- [Backend Documentation](backend/README.md)
---
**Made with ❤️ for the MCP Hackathon**
|