Unified Enterprise Knowledge Search (Advanced track)

projects/enterprise-search/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.py]
+indent_style = space
+indent_size = 4
+max_line_length = 88

projects/enterprise-search/.env.example

@@ -0,0 +1,67 @@
+# =============================================================================
+# Area51 - Environment Configuration
+# =============================================================================
+# Copy this file to .env and fill in your actual credentials
+# cp .env.example .env
+
+# =============================================================================
+# OpenAI Configuration
+# =============================================================================
+# Required for knowledge base embeddings and reranking
+OPENAI_API_KEY=your-openai-api-key-here
+
+# =============================================================================
+# Azure OpenAI Configuration (Alternative to OpenAI)
+# =============================================================================
+# Use Azure OpenAI instead of standard OpenAI
+AZURE_OPENAI_API_KEY=your-azure-openai-key-here
+AZURE_ENDPOINT=https://your-resource.openai.azure.com/
+AZURE_API_VERSION=2024-02-01
+AZURE_DEPLOYMENT=text-embedding-3-large
+AZURE_INFERENCE_DEPLOYMENT=gpt-4.1
+
+# =============================================================================
+# Confluence Configuration
+# =============================================================================
+# Required for Confluence integration
+CONFLUENCE_API_BASE=https://your-domain.atlassian.net
+CONFLUENCE_USERNAME=your-email@example.com
+CONFLUENCE_PASSWORD=your-confluence-api-token
+
+# =============================================================================
+# Jira Configuration (Optional)
+# =============================================================================
+# Configuration for Jira integration
+JIRA_API_BASE=https://your-domain.atlassian.net
+JIRA_USERNAME=your-email@example.com
+JIRA_API_TOKEN=your-jira-api-token
+
+# =============================================================================
+# Zendesk Configuration (Optional)
+# =============================================================================
+# Configuration for Zendesk integration
+ZENDESK_SUBDOMAIN=your-subdomain
+ZENDESK_EMAIL=your-email@example.com
+ZENDESK_API_TOKEN=your-zendesk-api-token
+
+# =============================================================================
+# pgvector Configuration
+# =============================================================================
+# Configuration for pgvector storage backend
+# Default values work for Docker-based MindsDB
+PGVECTOR_HOST=host.docker.internal
+PGVECTOR_PORT=5432
+PGVECTOR_DATABASE=postgres
+PGVECTOR_USER=postgres
+PGVECTOR_PASSWORD=admin
+
+
+# =============================================================================
+# Development/Testing
+# =============================================================================
+# Set to 'development' or 'production'
+ENVIRONMENT=development
+
+# Debug mode (set to 'true' for verbose logging)
+DEBUG=false
+LANGSMITH_API_KEY=test_key

projects/enterprise-search/.gitignore

@@ -0,0 +1,34 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+venv/
+ENV/
+.venv
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Environment
+.env
+.env.local
+
+# Logs
+*.log
+
+# Distribution
+dist/
+build/
+*.egg-info/
+
+test.ipynb
+test (2).ipynb
+
+.langgraph_api/
+uv.lock

projects/enterprise-search/Dockerfile

@@ -0,0 +1,7 @@
+FROM prasannatx/mindsdb:fix-jira-integration
+# FROM vigbav36/mindsdb:fix-jira-integration
+
+# Install MindsDB handlers for Jira and Zendesk
+RUN pip install 'mindsdb[jira]' 'mindsdb[zendesk]'
+
+# Image already binds to 0.0.0.0 - no changes needed

projects/enterprise-search/QUICKSTART.md

@@ -0,0 +1,38 @@
+# Area51 Quick Start
+
+**Required**
+1. Jira and confluence API key
+2. Zendesk API key
+3. Azure open AI credentials
+
+**Setup (one-time)**
+
+```bash
+
+# 0. Copy the example environment file and add the required parameters for the datasources
+cp .env.example .env
+
+# 1. Install dependencies
+uv sync
+
+# 2. Start Docker containers
+docker-compose up -d
+
+# 3. Run setup script
+uv run python setup.py --mode setup
+
+# 4. Open MindsDB UI
+open http://localhost:47334
+```
+
+**Run Evaluations**
+```bash
+# 1. Create test tables first
+uv run python utils/create_test_tables.py
+
+# 2. Run evaluation
+uv run python utils/evaluate_kb.py
+
+# Or use MindsDB Studio with the queries in README.md
+```
+