init

.gitignore

@@ -0,0 +1,30 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+venv/
+ENV/
+.venv
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+*.log
+.env
+test_*.py
+!backend/test_pdf_mapping.py
+
+# Temporary files
+*.tmp
+*.bak

PROJECT_SPEC.md

@@ -0,0 +1,218 @@
+# OpenAI Chatbot MCP v2 - Complete Project Specification
+
+## Project Overview
+
+**Location**: `/Users/jsv/Work/ataya/concert-master/AWS/backend/chatbot/openai_chatbot/openai-chatbot-mcp`
+
+**Description**: "doc specific rag + document reading + mcp for at will rag"
+
+**Goal**: Create an advanced OpenAI chatbot with version-specific document retrieval, MCP-style tools for flexible RAG queries, and page-level document access.
+
+## Architecture Summary
+
+### Core Components:
+
+1. **Multiple Vector Stores** (per version)
+   - Separate vector store for each document version (Harmony 1.2, 1.5, 1.6, 1.8, Chorus 1.1)
+   - One general/FAQ vector store for cross-version information
+   - Rationale: OpenAI vector stores don't support metadata filtering
+
+2. **Automatic Dual Querying**
+   - When user queries with a version (e.g., Harmony 1.8), automatically query:
+     - The version-specific vector store
+     - The general/FAQ vector store
+   - Append both results to the user query before sending to OpenAI
+
+3. **MCP-Style Tools** (implemented as OpenAI functions)
+   - **Vector Search Tool**: AI can query any vector store at will
+   - **Document Reader Tool**: AI can read specific pages or table of contents
+
+4. **Page-Level Document Access**
+   - Documents split into individual pages in `/pages` directory
+   - Table of contents (TOC) files for each document
+   - Tool behavior: No pages specified → return TOC; Pages specified → return page content
+
+## Requirements
+
+### User Interface (Gradio)
+- Version selector dropdown (defaults to Harmony 1.8)
+- Model selection (GPT-4.1, GPT-4.1 Mini, GPT-4.1 Nano, O4 Mini)
+- Custom prompt support
+- Real-time streaming responses
+- Token usage and cost tracking
+- Response time display
+- Deploy to Hugging Face Spaces
+
+### Backend Features
+- Support for multiple OpenAI vector stores
+- Version-to-vector-store mapping
+- Streaming responses
+- Cost calculation
+- Function calling for MCP-style tools
+
+### Document Versions
+- **Harmony**: 1.2, 1.5, 1.6, 1.8 (latest)
+- **Chorus**: 1.1 (latest)
+- Each version has User Guide and Installation Guide
+
+## Design Decisions
+
+### 1. Latest Version Handling
+- Config file will specify latest versions
+- Latest Harmony: 1.8
+- Latest Chorus: 1.1
+
+### 2. Version Ranges
+- Not needed - discrete tool calls only
+- User selects single version from dropdown
+
+### 3. Result Ranking
+- No complex ranking needed
+- Results clearly delineated by origin (version-specific vs general)
+- AI can parse and prioritize based on context
+
+### 4. Context Limits
+- Chunk size: ~1000 tokens
+- Maximum chunks: 10-20 (10,000-20,000 tokens)
+- Tradeoff: More context = better answers but higher cost
+- Recommendation: Start with 10 chunks, monitor performance
+
+## Technical Implementation
+
+### Project Structure
+```
+openai-chatbot-mcp/
+├── backend/
+│   ├── chatbot_backend.py         # Main backend with function calling
+│   ├── vector_store_manager.py    # Manages multiple vector stores
+│   ├── document_reader.py         # Page-level document access
+│   └── upload_versioned_pdfs.py   # Script to create version-specific stores
+├── frontend/
+│   └── gradio_app.py             # Gradio UI with version selection
+├── config/
+│   ├── vector_stores.json        # Maps versions to vector store IDs
+│   └── openai_config.json        # General configuration
+├── pages/                        # Existing page-level documents
+│   └── [document pages...]
+├── tools/
+│   ├── vector_search_tool.py     # Vector search function
+│   └── document_reader_tool.py   # Document reader function
+├── requirements.txt
+├── app.py                        # HF Spaces entry point
+└── README.md
+```
+
+### Vector Store Configuration Example
+```json
+{
+  "vector_stores": {
+    "harmony_1_2": "vs_xxx",
+    "harmony_1_5": "vs_xxx",
+    "harmony_1_6": "vs_xxx",
+    "harmony_1_8": "vs_xxx",
+    "chorus_1_1": "vs_xxx",
+    "general_faq": "vs_xxx"
+  },
+  "latest_versions": {
+    "harmony": "1.8",
+    "chorus": "1.1"
+  }
+}
+```
+
+### MCP Tool Schemas
+
+#### Vector Search Tool
+```python
+{
+    "name": "search_vector_store",
+    "description": "Search a specific vector store for relevant information",
+    "parameters": {
+        "query": "Search query string",
+        "vector_store_name": "Name of vector store (e.g., 'harmony_1_8', 'general_faq')",
+        "max_results": "Maximum number of results (default: 5)"
+    }
+}
+```
+
+#### Document Reader Tool
+```python
+{
+    "name": "read_document_pages",
+    "description": "Read specific pages from a document or get table of contents",
+    "parameters": {
+        "document_name": "Document identifier (e.g., 'Harmony_R1.8_UserGuide')",
+        "page_numbers": "List of page numbers to read (optional, returns TOC if not specified)"
+    }
+}
+```
+
+### Query Flow
+1. User selects version (e.g., Harmony 1.8) and asks question
+2. Backend automatically queries:
+   - `harmony_1_8` vector store
+   - `general_faq` vector store
+3. Results formatted and appended to query:
+   ```
+   Based on Harmony 1.8 documentation:
+   [version-specific chunks]
+   
+   Additional general information:
+   [FAQ/general chunks]
+   
+   User Question: [original question]
+   ```
+4. Query sent to OpenAI with function calling enabled
+5. AI can use tools to get more information if needed
+6. Response streamed back to user
+
+## Implementation Steps
+
+### Phase 1: Setup Vector Stores
+1. Create upload script for versioned PDFs
+2. Create separate vector stores for each version
+3. Upload PDFs to respective stores
+4. Create general/FAQ vector store
+5. Save configuration with store IDs
+
+### Phase 2: Backend Development
+1. Create `vector_store_manager.py` for multi-store handling
+2. Extend `chatbot_backend.py` with:
+   - Multiple vector store support
+   - Function calling integration
+   - Automatic dual querying
+3. Implement MCP-style tools as functions
+4. Add document reader functionality
+
+### Phase 3: Frontend Enhancement
+1. Add version selector dropdown
+2. Update UI to show which stores were queried
+3. Maintain existing features (streaming, cost tracking, etc.)
+4. Add source attribution display
+
+### Phase 4: Testing & Deployment
+1. Test version-specific queries
+2. Test cross-version queries using tools
+3. Test document page reading
+4. Deploy to Hugging Face Spaces
+
+## Reference Implementation
+- Simple version (single vector store): `/Users/jsv/Work/ataya/concert-master/AWS/backend/chatbot/openai_chatbot/openai-chatbot-simple`
+- Use as base for architecture and patterns
+
+## Notes for Implementation
+- MCP tools must be implemented as regular Python functions for HF Spaces
+- All configuration should use HF Spaces secrets for API keys
+- Maintain streaming support throughout
+- Keep cost tracking and response time features
+- Ensure clear source attribution in responses
+
+## Next Steps
+1. Start with creating the upload script for versioned PDFs
+2. Set up the vector store configuration
+3. Implement the backend components
+4. Enhance the frontend
+5. Test and deploy
+
+---
+**To continue this project**: Use this specification as context and begin implementation from Phase 1.

README.md

@@ -10,4 +10,80 @@ pinned: false
 short_description: doc specific rag + document reading + mcp for at will rag
 ---
 
+# OpenAI Chatbot MCP v2
+
+Advanced OpenAI chatbot with version-specific document retrieval, MCP-style tools for flexible RAG queries, and page-level document access.
+
+## Features
+
+- **Multi-Vector Store Support**: Separate vector stores for each product version
+- **Automatic Dual Querying**: Queries both version-specific and general FAQ stores
+- **MCP-Style Tools**:
+  - Vector Search Tool: AI can query any vector store at will
+  - Document Reader Tool: AI can read specific pages or table of contents
+- **Page-Level Document Access**: Documents split into individual pages
+- **Real-time Streaming**: Responses streamed in real-time
+- **Cost Tracking**: Token usage and cost calculation
+- **Multiple Models**: Support for GPT-4.1, GPT-4.1 Mini, GPT-4.1 Nano, O4 Mini
+
+## Quick Start on HuggingFace Spaces
+
+1. Set your `OPENAI_API_KEY` in the Space secrets
+2. Run the upload script to populate vector stores (see Setup below)
+3. Update `config/vector_stores.json` with actual vector store IDs
+4. The app will start automatically
+
+## Setup Instructions
+
+### 1. Environment Variables
+
+Set your OpenAI API key:
+```bash
+export OPENAI_API_KEY=your_api_key_here
+```
+
+### 2. Create Vector Stores
+
+Run the upload script to create version-specific vector stores:
+```bash
+python backend/upload_versioned_pdfs.py
+```
+
+This will:
+- Create separate vector stores for each version
+- Upload PDFs to respective stores
+- Save configuration in `config/vector_stores.json`
+
+### 3. Update Configuration
+
+After running the upload script, update the `config/vector_stores.json` file with the actual vector store IDs.
+
+### 4. Run Locally
+
+```bash
+python app.py
+```
+
+## Usage
+
+1. Select a product version from the dropdown (e.g., "Harmony 1.8")
+2. Choose an AI model
+3. Ask your question
+4. The AI will:
+   - Search the version-specific vector store
+   - Search the general FAQ store
+   - Use tools to find additional information if needed
+   - Provide a comprehensive answer
+
+## Tools Available to AI
+
+### Vector Search Tool
+- Searches any vector store for relevant information
+- Can target specific versions or general FAQ
+
+### Document Reader Tool
+- Reads specific pages from documents
+- Returns table of contents if no pages specified
+- Useful for detailed information retrieval
+
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

app.py

@@ -0,0 +1,20 @@
+"""
+Main application entry point for HuggingFace Spaces deployment.
+"""
+
+import os
+import sys
+from pathlib import Path
+
+# Add current directory to path
+sys.path.append(str(Path(__file__).parent))
+
+# Import the Gradio interface
+from frontend.gradio_app import create_gradio_interface
+
+# Create the interface
+app = create_gradio_interface()
+
+# Launch the app
+if __name__ == "__main__":
+    app.launch()

backend/vector_store_assistant_wrapper.py

@@ -0,0 +1,148 @@
+"""
+Vector Store Assistant Wrapper - Creates temporary assistants for querying vector stores.
+This is a compromise approach that allows dynamic vector store selection.
+"""
+
+import os
+import json
+import time
+from typing import Dict, List, Optional
+from openai import OpenAI
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+class VectorStoreAssistantWrapper:
+    def __init__(self, client: OpenAI):
+        """Initialize the assistant wrapper."""
+        self.client = client
+        self._assistant_cache = {}  # Cache assistants by vector store ID
+        
+    def _get_or_create_assistant(self, vector_store_id: str, store_name: str) -> str:
+        """Get existing or create new assistant for a vector store."""
+        # Check cache first
+        if vector_store_id in self._assistant_cache:
+            assistant_id = self._assistant_cache[vector_store_id]
+            try:
+                # Verify assistant still exists
+                self.client.beta.assistants.retrieve(assistant_id)
+                return assistant_id
+            except:
+                # Assistant was deleted, remove from cache
+                del self._assistant_cache[vector_store_id]
+        
+        # Create new assistant
+        try:
+            assistant = self.client.beta.assistants.create(
+                name=f"Search Assistant for {store_name}",
+                instructions=f"You are a search assistant for {store_name}. Search the attached documents and provide relevant information.",
+                model="gpt-4o-mini",  # Using mini for cost efficiency
+                tools=[{"type": "file_search"}],
+                tool_resources={
+                    "file_search": {
+                        "vector_store_ids": [vector_store_id]
+                    }
+                }
+            )
+            
+            # Cache the assistant
+            self._assistant_cache[vector_store_id] = assistant.id
+            logger.info(f"Created assistant {assistant.id} for vector store {vector_store_id}")
+            
+            return assistant.id
+            
+        except Exception as e:
+            logger.error(f"Error creating assistant: {e}")
+            raise
+    
+    def search_vector_store(self, vector_store_id: str, store_name: str, query: str, max_results: int = 5) -> List[Dict]:
+        """Search a vector store using a temporary assistant."""
+        try:
+            # Get or create assistant
+            assistant_id = self._get_or_create_assistant(vector_store_id, store_name)
+            
+            # Create a thread
+            thread = self.client.beta.threads.create()
+            
+            # Add the query message
+            self.client.beta.threads.messages.create(
+                thread_id=thread.id,
+                role="user",
+                content=f"Search for: {query}"
+            )
+            
+            # Run the assistant
+            run = self.client.beta.threads.runs.create_and_poll(
+                thread_id=thread.id,
+                assistant_id=assistant_id,
+                instructions=f"Search for information about: {query}. Return the most relevant excerpts.",
+                temperature=0.3
+            )
+            
+            # Check if run completed successfully
+            if run.status != 'completed':
+                logger.error(f"Run failed with status: {run.status}")
+                return []
+            
+            # Get messages
+            messages = self.client.beta.threads.messages.list(
+                thread_id=thread.id,
+                order="desc"
+            )
+            
+            # Extract results from assistant's response
+            results = []
+            for message in messages:
+                if message.role == "assistant":
+                    for content in message.content:
+                        if content.type == "text":
+                            # Extract text and any citations
+                            text_content = content.text.value
+                            
+                            # Parse annotations for file citations
+                            if hasattr(content.text, 'annotations'):
+                                for annotation in content.text.annotations:
+                                    if hasattr(annotation, 'file_citation'):
+                                        results.append({
+                                            "text": annotation.text,
+                                            "quote": annotation.file_citation.quote,
+                                            "file_id": annotation.file_citation.file_id
+                                        })
+                            
+                            # If no annotations, add the whole response
+                            if not results and text_content:
+                                # Split response into chunks
+                                chunks = text_content.split('\n\n')
+                                for chunk in chunks[:max_results]:
+                                    if chunk.strip():
+                                        results.append({
+                                            "text": chunk.strip(),
+                                            "quote": chunk.strip(),
+                                            "file_id": ""
+                                        })
+                            
+                            break
+                    break
+            
+            # Clean up thread
+            try:
+                self.client.beta.threads.delete(thread.id)
+            except:
+                pass
+            
+            return results[:max_results]
+            
+        except Exception as e:
+            logger.error(f"Error searching vector store: {e}")
+            return []
+    
+    def cleanup_assistants(self):
+        """Clean up cached assistants."""
+        for assistant_id in list(self._assistant_cache.values()):
+            try:
+                self.client.beta.assistants.delete(assistant_id)
+                logger.info(f"Deleted assistant {assistant_id}")
+            except:
+                pass
+        self._assistant_cache.clear()

backend/vector_store_manager.py

@@ -8,6 +8,7 @@ from typing import Dict, List, Optional, Tuple
 from pathlib import Path
 from openai import OpenAI
 import logging
+from .vector_store_assistant_wrapper import VectorStoreAssistantWrapper
 
 logger = logging.getLogger(__name__)
 
@@ -19,7 +20,10 @@ class VectorStoreManager:
         self.config_path = config_path or Path(__file__).parent.parent / "config" / "vector_stores.json"
         self.vector_stores = {}
         self.latest_versions = {}
+        self.descriptions = {}
         self.load_config()
+        # Initialize assistant wrapper for vector store searches
+        self.assistant_wrapper = VectorStoreAssistantWrapper(client)
     
     def load_config(self):
         """Load vector store configuration from file."""
@@ -32,6 +36,7 @@ class VectorStoreManager:
                 config = json.load(f)
                 self.vector_stores = config.get('vector_stores', {})
                 self.latest_versions = config.get('latest_versions', {})
+                self.descriptions = config.get('descriptions', {})
                 logger.info(f"Loaded {len(self.vector_stores)} vector stores from config")
         except Exception as e:
             logger.error(f"Error loading vector store config: {e}")
@@ -60,51 +65,18 @@ class VectorStoreManager:
             return []
         
         try:
-            # Create a thread for the query
-            thread = self.client.beta.threads.create()
+            # Get description for better context
+            description = self.descriptions.get(store_name, store_name)
             
-            # Add the query as a message
-            self.client.beta.threads.messages.create(
-                thread_id=thread.id,
-                role="user",
-                content=query
+            # Use assistant wrapper for search
+            results = self.assistant_wrapper.search_vector_store(
+                vector_store_id=store_id,
+                store_name=description,
+                query=query,
+                max_results=max_results
             )
             
-            # Run the assistant with the specific vector store
-            run = self.client.beta.threads.runs.create_and_poll(
-                thread_id=thread.id,
-                assistant_id="asst_temp",  # This will be replaced with actual assistant ID
-                tools=[{"type": "file_search"}],
-                tool_resources={
-                    "file_search": {
-                        "vector_store_ids": [store_id]
-                    }
-                }
-            )
-            
-            # Get the messages
-            messages = self.client.beta.threads.messages.list(
-                thread_id=thread.id,
-                order="asc"
-            )
-            
-            # Extract search results
-            results = []
-            for message in messages:
-                if message.role == "assistant":
-                    for content in message.content:
-                        if content.type == "text":
-                            # Parse file search annotations
-                            annotations = content.text.annotations
-                            for annotation in annotations:
-                                if annotation.type == "file_citation":
-                                    results.append({
-                                        "text": annotation.text,
-                                        "file_id": annotation.file_citation.file_id,
-                                        "quote": annotation.file_citation.quote
-                                    })
-            
-            return results[:max_results]
+            return results
             
         except Exception as e:
             logger.error(f"Error querying vector store '{store_name}': {e}")
@@ -175,4 +147,9 @@ class VectorStoreManager:
             for i, result in enumerate(general_results, 1):
                 formatted.append(f"{i}. {result.get('quote', result.get('text', ''))}")
         
-        return "\n".join(formatted)
+        return "\n".join(formatted)
+    
+    def cleanup(self):
+        """Cleanup any resources (like temporary assistants)."""
+        if hasattr(self, 'assistant_wrapper'):
+            self.assistant_wrapper.cleanup_assistants()

config/openai_config.json

@@ -0,0 +1,37 @@
+{
+  "models": {
+    "gpt-4o": {
+      "name": "GPT-4.1",
+      "description": "Most capable model",
+      "max_tokens": 128000,
+      "input_cost": 2.5,
+      "output_cost": 10.0
+    },
+    "gpt-4o-mini": {
+      "name": "GPT-4.1 Mini",
+      "description": "Affordable and intelligent",
+      "max_tokens": 128000,
+      "input_cost": 0.15,
+      "output_cost": 0.6
+    },
+    "gpt-4o-nano": {
+      "name": "GPT-4.1 Nano",
+      "description": "Fastest model",
+      "max_tokens": 128000,
+      "input_cost": 0.05,
+      "output_cost": 0.2
+    },
+    "o4-mini": {
+      "name": "O4 Mini",
+      "description": "Advanced reasoning",
+      "max_tokens": 128000,
+      "input_cost": 1.0,
+      "output_cost": 4.0
+    }
+  },
+  "default_model": "gpt-4o",
+  "temperature": 0.7,
+  "max_completion_tokens": 4000,
+  "chunk_size": 1000,
+  "max_chunks": 10
+}

config/vector_stores.json

@@ -0,0 +1,23 @@
+{
+  "vector_stores": {
+    "harmony_1_2": "vs_686db44dee9481918ded3a96e0fe2eb3",
+    "harmony_1_5": "vs_686db4581f14819183d14ecd6af34d48",
+    "harmony_1_6": "vs_686db462ef68819182bf27dd33168855",
+    "harmony_1_8": "vs_686db46d242881918505a7d9659fce06",
+    "chorus_1_1": "vs_686db47b2ee8819194c6d516766c0833"
+  },
+  "descriptions": {
+    "harmony_1_2": "Documentation for Harmony version 1.2",
+    "harmony_1_5": "Documentation for Harmony version 1.5",
+    "harmony_1_6": "Documentation for Harmony version 1.6",
+    "harmony_1_8": "Documentation for Harmony version 1.8",
+    "chorus_1_1": "Documentation for Chorus version 1.1"
+  },
+  "latest_versions": {
+    "harmony": "1.8",
+    "chorus": "1.1"
+  },
+  "created_at": "2025-07-08T19:15:09.549656",
+  "chunk_size": 1000,
+  "max_chunks": 10
+}

frontend/__init__.py

@@ -0,0 +1 @@
+# Frontend package

frontend/gradio_app.py

@@ -0,0 +1,281 @@
+"""
+Gradio Frontend for OpenAI Chatbot with Multi-Vector Store Support
+"""
+
+import gradio as gr
+import os
+import json
+import logging
+from typing import Dict, List, Tuple, Optional
+from pathlib import Path
+import time
+
+# Add parent directory to path for imports
+import sys
+sys.path.append(str(Path(__file__).parent.parent))
+
+from backend.chatbot_backend import ChatbotBackend
+
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger(__name__)
+
+
+class GradioApp:
+    def __init__(self):
+        """Initialize the Gradio application."""
+        self.chatbot = ChatbotBackend()
+        self.current_usage = {}
+        
+    def get_version_choices(self) -> List[str]:
+        """Get formatted version choices for dropdown."""
+        versions = self.chatbot.get_available_versions()
+        choices = []
+        
+        # Add Harmony versions
+        for version in versions.get("harmony", []):
+            choices.append(f"Harmony {version}")
+        
+        # Add Chorus versions
+        for version in versions.get("chorus", []):
+            choices.append(f"Chorus {version}")
+        
+        # Set default to latest Harmony
+        if choices:
+            latest_harmony = f"Harmony {self.chatbot.vector_store_manager.get_latest_version('harmony')}"
+            if latest_harmony in choices:
+                return choices, latest_harmony
+        
+        return choices, choices[0] if choices else "Harmony 1.8"
+    
+    def get_model_choices(self) -> List[str]:
+        """Get model choices for dropdown."""
+        models = self.chatbot.get_available_models()
+        choices = []
+        
+        for model_id, model_info in models.items():
+            choices.append(f"{model_info['name']} ({model_id})")
+        
+        return choices
+    
+    def parse_version_selection(self, selection: str) -> Tuple[str, str]:
+        """Parse version selection into product and version."""
+        parts = selection.split(" ", 1)
+        if len(parts) == 2:
+            return parts[0].lower(), parts[1]
+        return "harmony", "1.8"  # Default
+    
+    def parse_model_selection(self, selection: str) -> str:
+        """Extract model ID from selection."""
+        # Extract model ID from parentheses
+        if "(" in selection and ")" in selection:
+            return selection.split("(")[1].split(")")[0]
+        return "gpt-4o"  # Default
+    
+    def format_usage_info(self, usage: Dict) -> str:
+        """Format usage information for display."""
+        if not usage:
+            return ""
+        
+        info = []
+        
+        # Token usage
+        if "usage" in usage:
+            tokens = usage["usage"]
+            info.append(f"**Tokens**: Input: {tokens['input_tokens']:,} | Output: {tokens['output_tokens']:,} | Total: {tokens['total_tokens']:,}")
+        
+        # Cost
+        if "cost" in usage:
+            cost = usage["cost"]
+            info.append(f"**Cost**: Input: ${cost['input']:.4f} | Output: ${cost['output']:.4f} | Total: ${cost['total']:.4f}")
+        
+        # Response time
+        if "response_time" in usage:
+            info.append(f"**Response Time**: {usage['response_time']:.2f}s")
+        
+        # Model and version
+        if "model" in usage:
+            info.append(f"**Model**: {usage['model']}")
+        
+        if "version_context" in usage:
+            info.append(f"**Context**: {usage['version_context']}")
+        
+        return "\n\n".join(info)
+    
+    def stream_response(self, message: str, history: List[List[str]], 
+                       version: str, model: str, custom_prompt: str,
+                       temperature: float, max_tokens: int) -> Tuple[str, str]:
+        """Stream response from the chatbot."""
+        try:
+            # Parse selections
+            product, version_num = self.parse_version_selection(version)
+            model_id = self.parse_model_selection(model)
+            
+            # Initialize response
+            response = ""
+            
+            # Stream from backend
+            for chunk in self.chatbot.query_with_version(
+                query=message,
+                product=product,
+                version=version_num,
+                custom_prompt=custom_prompt if custom_prompt.strip() else None,
+                model=model_id,
+                temperature=temperature,
+                max_tokens=max_tokens
+            ):
+                if chunk["type"] == "content":
+                    response += chunk["content"]
+                    yield response, ""
+                
+                elif chunk["type"] == "metadata":
+                    # Store usage information
+                    self.current_usage = chunk
+                    usage_info = self.format_usage_info(chunk)
+                    yield response, usage_info
+                
+                elif chunk["type"] == "error":
+                    error_msg = f"\n\n❌ Error: {chunk['error']}"
+                    yield response + error_msg, ""
+        
+        except Exception as e:
+            logger.error(f"Error in stream_response: {str(e)}")
+            yield f"❌ Error: {str(e)}", ""
+    
+    def create_interface(self) -> gr.Blocks:
+        """Create the Gradio interface."""
+        version_choices, default_version = self.get_version_choices()
+        model_choices = self.get_model_choices()
+        
+        with gr.Blocks(title="OpenAI Chatbot - Multi-Version RAG") as interface:
+            gr.Markdown("# OpenAI Chatbot with Version-Specific Documentation")
+            gr.Markdown("Ask questions about Harmony or Chorus products. The AI will search version-specific documentation and can use tools to find more information.")
+            
+            with gr.Row():
+                with gr.Column(scale=3):
+                    chatbot = gr.Chatbot(
+                        height=500,
+                        show_label=False,
+                        elem_id="chatbot"
+                    )
+                    
+                    with gr.Row():
+                        msg = gr.Textbox(
+                            label="Your Question",
+                            placeholder="Ask about features, installation, configuration...",
+                            lines=2,
+                            scale=4
+                        )
+                        submit = gr.Button("Send", variant="primary", scale=1)
+                    
+                    usage_info = gr.Markdown(label="Usage Information")
+                
+                with gr.Column(scale=1):
+                    version_dropdown = gr.Dropdown(
+                        choices=version_choices,
+                        value=default_version,
+                        label="Product Version",
+                        info="Select the product version for context"
+                    )
+                    
+                    model_dropdown = gr.Dropdown(
+                        choices=model_choices,
+                        value=model_choices[0] if model_choices else "GPT-4.1 (gpt-4o)",
+                        label="Model",
+                        info="Select the AI model"
+                    )
+                    
+                    with gr.Accordion("Advanced Settings", open=False):
+                        temperature = gr.Slider(
+                            minimum=0,
+                            maximum=1,
+                            value=0.7,
+                            step=0.1,
+                            label="Temperature",
+                            info="Higher = more creative, Lower = more focused"
+                        )
+                        
+                        max_tokens = gr.Slider(
+                            minimum=100,
+                            maximum=8000,
+                            value=4000,
+                            step=100,
+                            label="Max Tokens",
+                            info="Maximum response length"
+                        )
+                        
+                        custom_prompt = gr.Textbox(
+                            label="Custom System Prompt",
+                            placeholder="Optional: Add custom instructions for the AI",
+                            lines=3
+                        )
+                    
+                    with gr.Accordion("Available Tools", open=True):
+                        gr.Markdown("""
+                        The AI has access to:
+                        - **Vector Search**: Search any version's documentation
+                        - **Document Reader**: Read specific pages or table of contents
+                        
+                        The AI will use these tools automatically when needed.
+                        """)
+                    
+                    clear = gr.Button("Clear Conversation")
+            
+            # Examples
+            gr.Examples(
+                examples=[
+                    ["How do I install Harmony on Windows?"],
+                    ["What are the new features in this version?"],
+                    ["How do I configure SSL certificates?"],
+                    ["What are the system requirements?"],
+                    ["How do I troubleshoot connection issues?"]
+                ],
+                inputs=msg
+            )
+            
+            # Event handlers
+            def user_submit(message, history):
+                return "", history + [[message, None]]
+            
+            def bot_response(history, version, model, custom_prompt, temperature, max_tokens):
+                if not history or not history[-1][0]:
+                    yield history, ""
+                    return
+                
+                user_message = history[-1][0]
+                history[-1][1] = ""
+                
+                for response, usage in self.stream_response(
+                    user_message, history[:-1], version, model, 
+                    custom_prompt, temperature, max_tokens
+                ):
+                    history[-1][1] = response
+                    yield history, usage
+            
+            # Connect events
+            msg.submit(user_submit, [msg, chatbot], [msg, chatbot], queue=False).then(
+                bot_response, 
+                [chatbot, version_dropdown, model_dropdown, custom_prompt, temperature, max_tokens], 
+                [chatbot, usage_info]
+            )
+            
+            submit.click(user_submit, [msg, chatbot], [msg, chatbot], queue=False).then(
+                bot_response, 
+                [chatbot, version_dropdown, model_dropdown, custom_prompt, temperature, max_tokens], 
+                [chatbot, usage_info]
+            )
+            
+            clear.click(lambda: ([], ""), outputs=[chatbot, usage_info])
+        
+        return interface
+
+
+def create_gradio_interface() -> gr.Blocks:
+    """Create and return the Gradio interface."""
+    app = GradioApp()
+    return app.create_interface()
+
+
+if __name__ == "__main__":
+    # For local testing
+    interface = create_gradio_interface()
+    interface.launch(debug=True)

pages/Chorus_R1.1_QuickStartGuide_TOC.txt

@@ -0,0 +1,32 @@
+TABLE OF CONTENTS
+Document: Chorus R1.1 Quick Start Guide
+Total Pages: 24
+Generated from: Chorus R1.1 Quick Start Guide.pdf
+==================================================
+
+1 Objective - Page 4
+2 Chorus AP - Page 5
+2.1 Brief Introduction - Page 5
+3 Quick Start Guide - Page 7
+3.1 Prerequisites - Page 7
+3.1.1 Chorus Cloud Account - Page 7
+3.1.2 Chorus Device - Page 8
+3.2 Quick Start Steps - Page 9
+3.2.1 Confirm 5G service configuration - Page 9
+3.2.2 Add Device - Page 9
+3.2.3 Create Client Credentials - Page 11
+3.2.4 IP address for Chorus Device - Page 13
+3.2.5 Configure IP address Pool for UE - Page 14
+3.2.6 Connect to Internet - Page 15
+3.2.7 Power On - Page 15
+3.2.8 Device Status - Page 15
+3.2.9 Connect UE/Clients - Page 16
+3.2.10  Using Customized Zone and DNN - Page 17
+3.2.10.1 Create Zone - Page 17
+3.2.10.2 Create DNN - Page 18
+4 Troubleshooting - Page 20
+4.1 Chorus Device Connection Failure - Page 20
+4.2 UE Connection Failure - Page 20
+Appendix 1  Glossary - Page 21
+Appendix 2  DHCP Requirement - Page 23
+Appendix 3  Concept of Zone - Page 23

pages/Chorus_R1.1_QuickStartGuide_page_001.txt

@@ -0,0 +1,8 @@
+Page 1
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 1 CHORUS QUICK START GUIDE 
+
+Chorus Release 1.1 
+Quick Start Guide

pages/Chorus_R1.1_QuickStartGuide_page_002.txt

@@ -0,0 +1,36 @@
+Page 2
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 2 CHORUS QUICK START GUIDE 
+Table of Contents 
+ 
+1 Objective ................................ ................................ ................................ ................................ .................... 4 
+2 Chorus AP ................................ ................................ ................................ ................................ ................... 5 
+2.1 Brief Introduction ................................ ................................ ................................ ............................... 5 
+3 Quick Start Guide ................................ ................................ ................................ ................................ ....... 7 
+3.1 Prerequisites ................................ ................................ ................................ ................................ ...... 7 
+3.1.1 Chorus Cloud Account ................................ ................................ ................................ ................ 7 
+3.1.2 Chorus Device ................................ ................................ ................................ ............................ 8 
+3.2 Quick Start Steps ................................ ................................ ................................ ................................ 9 
+3.2.1 Confirm 5G service configuration ................................ ................................ .............................. 9 
+3.2.2 Add Device ................................ ................................ ................................ ................................ . 9 
+3.2.3 Create Client Credentials ................................ ................................ ................................ ......... 11 
+3.2.4 IP address for Chorus Device ................................ ................................ ................................ ... 13 
+3.2.5 Configure IP address Pool for UE ................................ ................................ ............................. 14 
+3.2.6 Connect to Internet ................................ ................................ ................................ .................. 15 
+3.2.7 Power On ................................ ................................ ................................ ................................ .. 15 
+3.2.8 Device Status ................................ ................................ ................................ ............................ 15 
+3.2.9 Connect UE/Clients ................................ ................................ ................................ .................. 16 
+3.2.10 Using Customized Zone and DNN ................................ ................................ ............................ 17 
+3.2.10.1 Create Zone ................................ ................................ ................................ ...................... 17 
+3.2.10.2 Create DNN ................................ ................................ ................................ ...................... 18 
+4 Troubleshooting ................................ ................................ ................................ ................................ ....... 20 
+4.1 Chorus Device Connection Failure ................................ ................................ ................................ ... 20 
+4.2 UE Connection Failure ................................ ................................ ................................ ...................... 20 
+Appendix 1 Glossary ................................ ................................ ................................ ................................ .... 21 
+Appendix 2 DHCP Requirement ................................ ................................ ................................ .................. 23 
+Appendix 3 Concept of Zone ................................ ................................ ................................ ....................... 23 
+ 
+Table of Figures 
+Figure 1 Chorus Architecture ................................ ................................ ................................ ............................. 6

pages/Chorus_R1.1_QuickStartGuide_page_003.txt

@@ -0,0 +1,28 @@
+Page 3
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 3 CHORUS QUICK START GUIDE 
+Figure 2 Chorus invitation mail ................................ ................................ ................................ .......................... 7 
+Figure 3 Chorus first login password setup ................................ ................................ ................................ ........ 8 
+Figure 4 Chorus main page ................................ ................................ ................................ ................................ 8 
+Figure 5 Service Configuration ................................ ................................ ................................ ........................... 9 
+Figure 6 Add Chorus Device ................................ ................................ ................................ ............................. 10 
+figure 7 Chorus Device configuration ................................ ................................ ................................ ............... 10 
+Figure 8 Device Serial Number and MAC information ................................ ................................ ..................... 10 
+Figure 9 Devices list shows successfully created Chorus device ................................ ................................ ...... 11 
+Figure 10 Upload / Fetch Client Credentials ................................ ................................ ................................ .... 11 
+Figure 11 A single 5G client credential configuration ................................ ................................ ...................... 12 
+Figure 12 Configure the policies for the client ................................ ................................ ................................ . 12 
+Figure 13 Chorus Structure ................................ ................................ ................................ .............................. 13 
+Figure 14 Configure UE IP Pools ................................ ................................ ................................ ....................... 14 
+Figure 15 UE IP address ................................ ................................ ................................ ................................ .... 14 
+Figure 16 UE gets IP via external DHCP server ................................ ................................ ................................ . 15 
+Figure 17 Chorus Device status ................................ ................................ ................................ ........................ 15 
+Figure 18 Chorus Device Details ................................ ................................ ................................ ...................... 16 
+Figure 19 Active Clients shown on Cloud Dashboard ................................ ................................ ...................... 17 
+Figure 20 Add a New Zone ................................ ................................ ................................ ............................... 17 
+Figure 21 Input Zone Detail ................................ ................................ ................................ .............................. 18 
+Figure 22 Setup DNN in Chorus ................................ ................................ ................................ ....................... 19 
+Figure 23 Chorus Zone  UE can reach another UE on different Chorus AP in Zone ................................ ....... 24 
+Figure 24 Chorus Zone  Chorus Zone with source NAT ................................ ................................ .................. 24

pages/Chorus_R1.1_QuickStartGuide_page_004.txt

@@ -0,0 +1,12 @@
+Page 4
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 4 CHORUS QUICK START GUIDE 
+Revision History 
+Version Contents Date 
+1.0 Initial Release d Version April 10 , 2025 
+ 
+1 Objective 
+This document describe s the quick start steps of Ataya Chorus and the usage of Ataya Chorus after it is 
+installed .

pages/Chorus_R1.1_QuickStartGuide_page_005.txt

@@ -0,0 +1,32 @@
+Page 5
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 5 CHORUS QUICK START GUIDE 
+2 Chorus AP 
+2.1 Brief Introduction 
+Private 5G solutions remain complex for small to medium -sized deployments. On -site installation of 
+hardware and software for the 5G Core and network integration into existing systems are challenging 
+tasks. Additionally, monitoring, troubleshooting, software upgrades, and other maintenance activities add 
+to this complexity . 
+In many use cases, such as retail stores, gas stations, oil and gas operations, smart agriculture, and 
+emergency response systems, customers find the current 5G solutions overly burdensome. They are 
+looking for a simpler solution that reduces setup time an d requires minimal on -site configuration. They 
+need a plug -and-play system where gNBs connect to the internet and provide instant 5G service. 
+It is essential to reduce operational complexity with a centralized cloud -managed dashboard for all remote 
+sites and to lower costs by eliminating the need for servers, switches, and other hardware. 
+Chorus AP is the perfect answer for this concern . The key futures of Chorus are listed as follows : 
+ Deployment simplicity: 
+Experience true zero -touch deployment just plug in the Chorus AP, and it works. 
+ Data stays on -premises: 
+The Harmony data plane is contained within the Chorus AP. 
+ Simplified device onboarding: 
+ The multi -tenanted control plane is hosted in the cloud and automatically connects to the Chorus 
+AP on boot -up. 
+ Device onboarding is managed through a cloud management dashboard. 
+The target use cases are listed as follows : 
+ Enable quick point -to-point 5G connections in oil & gas, factory shop floors, vision -based use cases, 
+and more. 
+ Enterprise customers are looking to augment Wi -Fi with 5G, such as in parking lots or airports for 
+cameras, or for private networks in venues and stadiums. 
+ Ideal for small deployments of 1 to 5 nodes.

pages/Chorus_R1.1_QuickStartGuide_page_006.txt

@@ -0,0 +1,7 @@
+Page 6
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 6 CHORUS QUICK START GUIDE 
+ 
+Figure 1 Chorus Architecture

pages/Chorus_R1.1_QuickStartGuide_page_007.txt

@@ -0,0 +1,17 @@
+Page 7
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 7 CHORUS QUICK START GUIDE 
+3 Quick Start Guide 
+3.1 Prerequisites 
+Chorus is designed for convenient deployment . There are only 2 prerequisites: 
+ Chorus Cloud account 
+ Chorus Device 
+ 
+3.1.1 Chorus Cloud Account 
+To activate your account, check the invitation mail from Ataya Chorus . Click the ACCEPT INVITATION button 
+and you will be redirected to the Chorus page . Then you will be required to set a password with complexity. 
+Examples are shown as follows : 
+ 
+Figure 2 Chorus invitation mail

pages/Chorus_R1.1_QuickStartGuide_page_008.txt

@@ -0,0 +1,14 @@
+Page 8
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 8 CHORUS QUICK START GUIDE 
+ 
+Figure 3 Chorus first login password setup 
+Then you should see the main page of Chorus with your successfully created account. Examples are as 
+follows : 
+ 
+Figure 4 Chorus main page 
+3.1.2 Chorus Device 
+The Chorus Device refers to the hardware that had been integrated with Chorus Agent , Chorus Data Plane 
+and the gNB.

pages/Chorus_R1.1_QuickStartGuide_page_009.txt

@@ -0,0 +1,20 @@
+Page 9
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 9 CHORUS QUICK START GUIDE 
+3.2 Quick Start Steps 
+3.2.1 Confirm 5G service configuration 
+There are four main configuration sections related to 5G services: Traffic Related Configuration , 5G Related 
+Configuration, Network Configuration and Device Time Synchronization . Chorus comes with a default set 
+of configurations, but you need to confirm those mandatory parameters (the one with a red asterisk before 
+column name) such as PLMN (MCC and MNC), Slice type and ID, Tracking Area range. Confirm these 
+configurations by cli cking Organization on the top menu bar and hit the Service Configuration on the left 
+side-menu. Examples are shown below: 
+
+Figure 5 Service Configuration 
+3.2.2 Add Device 
+After all the prerequisites mentioned in 3.1 are ready, the first thing to do is to register Chorus Device and 
+configure related setting on Chorus Cloud (https://dashboard -chorus.ataya.io/dashboard ). Log in with your 
+Chorus account and click the Device s on top menu bar and click +Add Device button on the top -right. And 
+input the device name, MAC address and serial number. Examples are as follows :

pages/Chorus_R1.1_QuickStartGuide_page_010.txt

@@ -0,0 +1,19 @@
+Page 10
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 10 CHORUS QUICK START GUIDE 
+ 
+Figure 6 Add Chorus Device 
+ 
+figure 7 Chorus Device configuration 
+ Device name: Chorus Cell Name 
+ MAC address : MAC address of Chorus Cell. Example FC:B2D6:F6:D6:F7 
+ Serial Number :12 digi t of Serial Number for Chorus Cell, Example SC280600079 
+ Zone: Choose which Zone this device belongs to. Default: {Your Organization Name }. Refer 
+to Appendix 3 for more details about Zone . 
+ 
+You can find the Serial Number and MAC address information on the Chorus devices, examples as 
+following: 
+ 
+Figure 8 Device Serial Number and MAC information

pages/Chorus_R1.1_QuickStartGuide_page_011.txt

@@ -0,0 +1,22 @@
+Page 11
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 11 CHORUS QUICK START GUIDE 
+ 
+If Chorus device is successfully created, you will see your device on the Devices list, as shown below: 
+ 
+Figure 9 Devices list shows successfully created Chorus device 
+Please ensure that your license is valid and within the expiration period; otherwise, Chorus will not 
+establish the tunnel between the Chorus AP and the cloud core network. 
+ 
+3.2.3 Create Client Credentials 
+To configure new 5G clients, click on Clients on the top menu bar. Then you can click the + Credentials 
+button on the top -right and choose either Upload / Fetch Client Credentials (.csv) to upload a list of client 
+credentials in CSV format or Enter Credential Info to enter a single client credential. 
+ 
+To upload a CSV file with client credentials, click the sample CSV file to download a sample file first to make 
+sure your CSV file contains all needed columns. 
+ 
+Figure 10 Upload / Fetch Client Credentials 
+If you select Enter Credential Info , you can enter a single client credential configuration:

pages/Chorus_R1.1_QuickStartGuide_page_012.txt

@@ -0,0 +1,20 @@
+Page 12
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 12 CHORUS QUICK START GUIDE 
+ 
+Figure 11 A single 5G client credential configuration 
+ Subscriber Name: for display purposes 
+ IMSI/SUPI: 5G subscriber identity 
+ Key, OPC: the credential of the subscriber 
+ Status: The client can be in assigned or not -assigned state. If it is in not-assigned state , Chorus will 
+deny this 5G client access . 
+ 
+For the Access Mobility Data section, please fill in your configuration as below: 
+ 
+Figure 12 Configure the policies for the client 
+You can apply policy about this client as follows : 
+ Static IP address 
+You can configure a static IP address for the 5G UE but must be out of the configured UE IP range 
+pool of the DNN (those IP addresses could be assigned to other UEs).

pages/Chorus_R1.1_QuickStartGuide_page_013.txt

@@ -0,0 +1,27 @@
+Page 13
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 13 CHORUS QUICK START GUIDE 
+ Bandwidth Limit 
+To limit maximum rates (UE AMBR) , update the AMBR Uplink and AMBR Downlink to the desired 
+values for the specific UE. This value will take precedence over a global UE AMBR in Service 
+Configuration for this specific UE. 
+ IMEI Lock 
+Enabling this option will restrict th e enter SIM information for the specific UE to be used only by a 
+device with the given IMEI . 
+ Policy 
+If there are predefined policies in Harmony system, the Policy drop down menu will show the 
+configured policies. Note that each client can only assign one policy. 
+ 
+3.2.4 IP address for Chorus Device 
+Chorus requires a DHCP (Dynamic Host Configuration Protocol ) serve r in yo ur Data Network. Chorus will 
+ask your DHCP server for two dynamic IP addresses : Mgmt -ip and N6_IP (see Appendix for DHCP 
+requirements). If there is a DHCP server in your Data Network, you do not need to configure it manually. 
+ 
+The structure of Chorus data network is shown as follows : 
+ 
+Figure 13 Chorus Structure 
+Note that if you are using a L2/L3 switch, the mode of connection between Chorus AP to your switch must 
+NOT be set to trunk mode. Both the Mgmt -ip and N6_IP on the Chorus AP are logical interfaces, sharing a 
+single physical interface.

pages/Chorus_R1.1_QuickStartGuide_page_014.txt

@@ -0,0 +1,20 @@
+Page 14
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 14 CHORUS QUICK START GUIDE 
+ 
+3.2.5 Configure IP address Pool for UE 
+The IP that UE will get is determined by Zone configuration. To change this setting, click the 3 -dots icon on 
+the right of your Zone , hit the Edit Zone and toggle the switch of NAT. 
+ 
+Figure 14 Configure UE IP Pools 
+NAT enabled / disabled: 
+ If NAT is enabled, UEs will share the N6 IP address for outbound network traffic. The internal UE IP 
+pool is 192.168.65.1 ~ 192.168.65.254 by default. 
+ If NAT is disabled, you must ensure that the start and end IP addresses align with the Zone's subnet 
+(refer to Appendix 3 for details on zones and IP subnets). Additionally, verify that these IP addresses 
+are not assigned to other clients within the Zone. The quantity of IP addresses should correspond to 
+the expected number of UEs to be supported in the Zone. 
+ 
+Figure 15 UE IP address

pages/Chorus_R1.1_QuickStartGuide_page_015.txt

@@ -0,0 +1,27 @@
+Page 15
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 15 CHORUS QUICK START GUIDE 
+UE uses DHCP to get an IP from external server (Beta) : 
+A beta feature is currently available that allows the UE to obtain an IP address from an external DHCP 
+server. If this feature is enabled, the UE will receive its IP address from the external DHCP server. Please 
+note that this setting cannot be modified once a Zone has been created. To utilize this feature, you must 
+create a new Zone and migrate your device to it. 
+ 
+Figure 16 UE gets IP via external DHCP server 
+3.2.6 Connect to Internet 
+Connect the Chorus Device to an internet connection by using an Ethernet cable from the port labeled 
+Internet to switch/router in your site. Please ensure that the router provides DHCP service . 
+ 
+3.2.7 Power On 
+After the configuration on Chorus cloud dashboard is done, connect the power supply and power on 
+Chorus AP and wait for the initialization (after initialization it will reboot automatically ). Once the reboot is 
+done and the service is up, you can check the status of Chorus Device by its LED indicators. 
+ 
+3.2.8 Device Status 
+You can check the status of the Chorus device in Devices tab. You can hit the Details page to get additional 
+information about the device and its status. If device is connected it should show something like this 
+ 
+Figure 17 Chorus Device status 
+And on clicking the details you should see all three sections as green

pages/Chorus_R1.1_QuickStartGuide_page_016.txt

@@ -0,0 +1,11 @@
+Page 16
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 16 CHORUS QUICK START GUIDE 
+ 
+Figure 18 Chorus Device Details 
+ 
+3.2.9 Connect UE /Clients 
+Now the Chorus AP is ready to work. Y ou can turn on your client . Check the status of your client in the 
+Chorus cloud dashboard in the Insights & Analytics ->Client Statistics tab.

pages/Chorus_R1.1_QuickStartGuide_page_017.txt

@@ -0,0 +1,17 @@
+Page 17
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 17 CHORUS QUICK START GUIDE 
+ 
+Figure 19 Active Clients shown on Cloud Dashboard 
+3.2.10 Using Customized Zone and DNN 
+Chorus comes with default Zone : {your organization name} and default DNN : internet . If you want to 
+change Zone name to your preference or change DNN name, you can follow the instruction below: 
+ 
+3.2.10.1 Create Zone 
+A Zone in Chorus represents a broad label for a specific area or region. To Create a new Zone, first click the 
+Devices on the top menu bar, then click the Gear button on the top -right, as follows : 
+ 
+Figure 20 Add a New Zone 
+And input your zone details as following figure:

pages/Chorus_R1.1_QuickStartGuide_page_018.txt

@@ -0,0 +1,20 @@
+Page 18
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 18 CHORUS QUICK START GUIDE 
+ 
+Figure 21 Input Zone Detail 
+ Zone Name: Provide a name 
+ Zone Description: Provide a description 
+ NAT (Network address translation) : If enabled NAT, The UE will share N6 IP address for outbound 
+network and IP range for UE will setting 192.168.65.1 -192.168.65.254 by default. 
+ IP Range : IP pool for UE: IP range for UE. This pool shall R eserve a range of IP address f rom DHCP 
+server . 
+ DHCP from external server (Beta): if this is enabled, UE will get an IP from an external DHCP 
+server. 
+ 
+3.2.10.2 Create DNN 
+Select DNN configuration on the left sidebar . Chorus System comes with a default DNN called internet  
+and ready to be used. But if you want to add a new DNN, you can click the +DNN Configuration on the top -
+right and input the DNN name, 5QI and ARP as you desire. Examples are shown as follows .

pages/Chorus_R1.1_QuickStartGuide_page_019.txt

@@ -0,0 +1,7 @@
+Page 19
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 19 CHORUS QUICK START GUIDE 
+ 
+Figure 22 Setup DNN in Chorus

pages/Chorus_R1.1_QuickStartGuide_page_020.txt

@@ -0,0 +1,17 @@
+Page 20
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 20 CHORUS QUICK START GUIDE 
+4 Trouble shoot ing 
+4.1 Chorus Device Connection Failure 
+ Please check if Device has been configured (check MAC and S/N) 
+ Please check if device has license 
+ Please check internet connectivity 
+4.2 UE Connection Failure 
+ Please check if Chorus device is active/connected (Devices tab) 
+ Please check if SIM used in UE is configured in Chorus Cloud (clients tab) 
+ Please check if DNN configured in UE matches that in Chorus Cloud (Organization ->DNN 
+configuration) 
+ If NAT is disabled, please check if IP address assigned to UE matches your Zone IP (Devices ->Edit 
+Zone)

pages/Chorus_R1.1_QuickStartGuide_page_021.txt

@@ -0,0 +1,27 @@
+Page 21
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 21 CHORUS QUICK START GUIDE 
+Appendix 1 Glossary 
+Terminology Definition 
+5GC 5G Core network 
+5QI 5G QoS Identifier 
+AKA Authentication & Key Management ( e.g., 5G-AKA) 
+AMBR Aggregate Maximum Bit Rate 
+AMF Access & mobility Management Function 
+ARP Address Resolution Protocol, or 
+Allocation & Retention Priority 
+AUSF Authentication Server Function 
+CQI Channel Quality Indicator 
+CSV Comma -Separated Values file is a text file saved in a table structure format 
+DNN Data Network Name 
+DNS Domain Name System 
+EAP-AKA Extensible Authentication Protocol - AKA 
+EAP-TLS Extensible Authentication Protocol - Transport Layer Security 
+EMS Element Management System 
+gNB next Generation NodeB (the name of a 5G base station) 
+gNB Zone A group of gNBs; can be defined as a statistics calculation and display unit 
+GW Gateway 
+IMEI International Mobile Equipment Identity 
+IMSI International Mobile Subscriber Identity

pages/Chorus_R1.1_QuickStartGuide_page_022.txt

@@ -0,0 +1,30 @@
+Page 22
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 22 CHORUS QUICK START GUIDE 
+KPI Key Performance Indicator 
+MAD Mean Absolute Deviation 
+MCC Mobile Country Code 
+MNC Mobile Network Code 
+MSP Managed Service Provider 
+N3W Interface of UIWF for Wi-Fi/wired networks 
+Network A Harmony Network represents a Kubernetes cluster, is one or a group of nodes 
+(hosts ) running Harmony services (data, control, & management) under one 
+configuration . 
+Node A Node in a Kubernetes cluster runs as an instance (virtual machine) . For Harmony by 
+default a host has a node running on it. A node runs one or more pods in it. 
+Pod A Kubernetes Pod is the smallest deployable unit that can be created and managed. It 
+runs one or more containers. A Linux analogy for a pod is similar to a set of containers 
+with shared namespaces and filesystem volumes. 
+QoS Quality of Service 
+RAN Radio Access Network 
+RAT Radio Access Technology 
+SI Systems Integrator 
+Site A Harmony site is a location with a data plane running at the location 
+SMS Short Messaging Service 
+SMTP Simple Mail Transfer Protocol 
+SN or SQN Sequence Number 
+SSH Secure Shell protocol 
+SUPI Subscription Permanent Identifier 
+TAC Tracking Area Code

pages/Chorus_R1.1_QuickStartGuide_page_023.txt

@@ -0,0 +1,31 @@
+Page 23
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 23 CHORUS QUICK START GUIDE 
+TAI Tracking Area Identity 
+(PLMN + TAC) 
+UIWF Universal Inter -Working Function 
+UPF User Plane Function ; the 5G terminology for data plane 
+Zone (see Device Zone in section 0) 
+ 
+Appendix 2 DHCP Requirement 
+To ensure the Chorus system operates correctly , there are several requirements about the DHCP server 
+configuration listed as follows : 
+ Allocate IP addresses for Mgmt and N6 based on their MAC Address 
+ Provide subnet prefix / netmask in DHCP Offer 
+ Provide Gateway IP address in DHCP Offer 
+ Provide DNS server IP address in DHCP Offer 
+ Reserve a range of IP addresses for UE (not dynamic allocated) 
+Appendix 3 Concept of Zone 
+To better manage all the Chorus APs, Ataya introduced the concept of Zones. The design of Zones allows 
+you to categorize and manage all your Chorus APs and control the network connectivity between them. 
+In general, the Chorus AP requires the customer network to enable connectivity from the Chorus AP to the 
+Chorus Cloud through a DHCP -assigned management IP and a network gateway. The Chorus AP will need 
+another DHCP -assigned data plane IP address to provide 5G UE connectivity to local, internal, and external 
+services. 
+When a Chorus zone disables data plane NAT, Chorus zone enables additional possibilities: 
+ The Chorus zone allows services to initiate connections to a 5G UE served by a Chorus AP in the 
+Chorus zone. 
+ The Chorus zone allows a 5G UE to initiate connections to a 5G UE served by another Chorus AP in 
+the same Chorus zone.

pages/Chorus_R1.1_QuickStartGuide_page_024.txt

@@ -0,0 +1,17 @@
+Page 24
+Document: Chorus R1.1 Quick Start Guide
+==================================================
+
+Ataya Proprietary and Confidential 24 CHORUS QUICK START GUIDE 
+To achieve these capabilities, 5G UEs are assigned IP addresses from a Chorus zone IP address pool 
+allocated from the subnetwork the Chorus AP is attached to. This pool should be outside of the address 
+pool used by the DHCP server on the subnetwork. The 5G UE will keep its assigned address when it moves 
+among Chorus APs in the zone. 
+ 
+Figure 23 Chorus Zone  UE can reach another UE on different Chorus AP in Zone 
+When users keep the Chorus zone data plane NAT enabled, the attached 5G UEs will be assigned IP 
+address es caged within the Chorus AP they are attached to . In mobility handover, t he NAT caged IP 
+address cannot be carried to or from a Chorus AP. Services will not be able to initiate access to t hese caged 
+IP addresses. 
+ 
+Figure 24 Chorus Zone  Chorus Zone with source NAT

pages/Chorus_R1.1_UserGuide_TOC.txt

@@ -0,0 +1,73 @@
+TABLE OF CONTENTS
+Document: Chorus R1.1 User Guide
+Total Pages: 70
+Generated from: Chorus R1.1 User Guide.pdf
+==================================================
+
+1 Objective - Page 9
+2 Chorus AP - Page 10
+2.1 Brief Introduction - Page 10
+3 Prerequisites - Page 12
+3.1 Chorus Cloud Account - Page 12
+3.2 Chorus Device - Page 13
+4 Dashboard for Chorus - Page 14
+4.1 Insights & Analytics - Page 14
+4.1.1 Overview - Page 14
+4.1.2 Network Statistics - Page 15
+4.1.3 Device Statistics - Page 16
+4.1.4 Client Statistics - Page 19
+4.1.5 Alerts - Page 21
+4.2 Devices - Page 25
+4.2.1 Views for Devices - Page 25
+4.2.1.1 Types of View - Page 25
+4.2.1.2 Configure Device Location for Map View - Page 27
+4.2.1.3 Upload Indoor Site Map and Set Device Position - Page 27
+4.2.2 Manage Zone - Page 29
+4.2.2.1 Creating a New Zone - Page 29
+4.2.2.2 Edit a Zone - Page 30
+4.2.2.3 Manage Neighbor List - Page 31
+4.2.2.4 Delete a Zone - Page 32
+4.2.3 Manage Device - Page 32
+4.2.3.1 Add Device - Page 32
+4.2.3.2 Edit An existing Device - Page 34
+4.2.3.3 Manage License - Page 37
+4.2.3.4 Manage Neighbor List - Page 38
+4.2.3.5 Reboot a Device - Page 38
+4.2.3.6 Restart UPF - Page 39
+4.2.3.7 Upload Log - Page 39
+4.2.3.8 Delete Device - Page 40
+4.2.3.9 Turn On/Off Radio - Page 40
+4.2.3.10 Device Details - Page 41
+4.2.3.11 Device Events - Page 43
+4.3 Clients - Page 44
+4.3.1 Creating New Clients - Page 44
+4.3.2 Edit Clients - Page 46
+4.3.3 Assign / unassign clients - Page 47
+4.3.4 Block clients - Page 48
+4.3.5 Delete Clients - Page 49
+4.4 Policies - Page 50
+4.4.1 Set Bandwidth Limit - Page 51
+4.4.2 Enable Application Slicing - Page 51
+4.4.3 Enable IP Filtering - Page 52
+4.4.4 Enable Time Schedule - Page 53
+4.4.5 Applying a Configured Policy to a Client - Page 53
+4.4.6 Clone Policy - Page 54
+4.4.7 Set as default - Page 55
+4.4.8 View Attached Clients - Page 55
+4.4.9 Delete Policy - Page 56
+4.5 Organization - Page 56
+4.5.1 User Management - Page 56
+4.5.1.1 Inviting New User - Page 56
+4.5.1.2 Delete User - Page 57
+4.5.2 Private Key Management - Page 57
+4.5.3 Settings - Page 58
+4.5.3.1 Timezone And License - Page 58
+4.5.3.2 Alert Notifications - Page 59
+4.5.4 Service Configuration - Page 62
+4.5.5 DNN Configuration - Page 63
+4.5.6 Audit - Page 63
+4.6 Help Center - Page 64
+Appendix 1  Glossary - Page 66
+Appendix 2  DHCP Requirement - Page 68
+Appendix 3  Concept of Zone - Page 68
+Appendix 4  DHCP Server Configuration Example (isc-DHCP) - Page 70

pages/Chorus_R1.1_UserGuide_page_001.txt

@@ -0,0 +1,8 @@
+Page 1
+Document: Chorus R1.1 User Guide
+==================================================
+
+Ataya Proprietary and Confidential 1 CHORUS USER GUIDE 
+
+Chorus Release 1.1 
+User Guide

pages/Chorus_R1.1_UserGuide_page_002.txt

@@ -0,0 +1,36 @@
+Page 2
+Document: Chorus R1.1 User Guide
+==================================================
+
+Ataya Proprietary and Confidential 2 CHORUS USER GUIDE 
+Table of Contents 
+ 
+1 Objective ................................ ................................ ................................ ................................ .................... 9 
+2 Chorus AP ................................ ................................ ................................ ................................ ................. 10 
+2.1 Brief Introduction ................................ ................................ ................................ ............................. 10 
+3 Prerequisites ................................ ................................ ................................ ................................ ............ 12 
+3.1 Chorus Cloud Account ................................ ................................ ................................ ...................... 12 
+3.2 Chorus Device ................................ ................................ ................................ ................................ .. 13 
+4 Dashboard for Chorus ................................ ................................ ................................ .............................. 14 
+4.1 Insights & Analytics ................................ ................................ ................................ .......................... 14 
+4.1.1 Overview ................................ ................................ ................................ ................................ .. 14 
+4.1.2 Network Statistics ................................ ................................ ................................ .................... 15 
+4.1.3 Device Statistics ................................ ................................ ................................ ....................... 16 
+4.1.4 Client Statistics ................................ ................................ ................................ ......................... 19 
+4.1.5 Alerts ................................ ................................ ................................ ................................ ........ 21 
+4.2 Devices ................................ ................................ ................................ ................................ ............. 25 
+4.2.1 Views for Devices ................................ ................................ ................................ ..................... 25 
+4.2.1.1 Types of View ................................ ................................ ................................ ....................... 25 
+4.2.1.2 Configure Device Location for Map View ................................ ................................ ............ 27 
+4.2.1.3 Upload Indoor Site Map and Set Device Position ................................ ................................ 27 
+4.2.2 Manage Zone ................................ ................................ ................................ ........................... 29 
+4.2.2.1 Creating a New Zone ................................ ................................ ................................ ............ 29 
+4.2.2.2 Edit a Zone ................................ ................................ ................................ ............................ 30 
+4.2.2.3 Manage Neighbor List ................................ ................................ ................................ .......... 31 
+4.2.2.4 Delete a Zone ................................ ................................ ................................ ....................... 32 
+4.2.3 Manage Device ................................ ................................ ................................ ......................... 32 
+4.2.3.1 Add Device ................................ ................................ ................................ ........................... 32 
+4.2.3.2 Edit An existing Device ................................ ................................ ................................ ......... 34 
+4.2.3.3 Manage License ................................ ................................ ................................ ................... 37 
+4.2.3.4 Manage Neighbor List ................................ ................................ ................................ .......... 38 
+4.2.3.5 Reboot a Device ................................ ................................ ................................ ................... 38

pages/Chorus_R1.1_UserGuide_page_003.txt

@@ -0,0 +1,36 @@
+Page 3
+Document: Chorus R1.1 User Guide
+==================================================
+
+Ataya Proprietary and Confidential 3 CHORUS USER GUIDE 
+4.2.3.6 Restart UPF ................................ ................................ ................................ ........................... 39 
+4.2.3.7 Upload Log ................................ ................................ ................................ ........................... 39 
+4.2.3.8 Delete Device ................................ ................................ ................................ ....................... 40 
+4.2.3.9 Turn On/Off Radio ................................ ................................ ................................ ................ 40 
+4.2.3.10 Device Details ................................ ................................ ................................ ................... 41 
+4.2.3.11 Device Events ................................ ................................ ................................ ................... 43 
+4.3 Clients ................................ ................................ ................................ ................................ ............... 44 
+4.3.1 Creating New Clients ................................ ................................ ................................ ................ 44 
+4.3.2 Edit Clients ................................ ................................ ................................ ............................... 46 
+4.3.3 Assign / unassign clients ................................ ................................ ................................ .......... 47 
+4.3.4 Block clients ................................ ................................ ................................ ............................. 48 
+4.3.5 Delete Clients ................................ ................................ ................................ ........................... 49 
+4.4 Policies ................................ ................................ ................................ ................................ ............. 50 
+4.4.1 Set Bandwidth Limit ................................ ................................ ................................ ................. 51 
+4.4.2 Enable Application Slicing ................................ ................................ ................................ ........ 51 
+4.4.3 Enable IP Filtering ................................ ................................ ................................ .................... 52 
+4.4.4 Enable Time Schedule ................................ ................................ ................................ .............. 53 
+4.4.5 Applying a Configured Policy to a Client ................................ ................................ .................. 53 
+4.4.6 Clone Policy ................................ ................................ ................................ .............................. 54 
+4.4.7 Set as default ................................ ................................ ................................ ............................ 55 
+4.4.8 View A ttached Clients ................................ ................................ ................................ .............. 55 
+4.4.9 Delete Policy ................................ ................................ ................................ ............................. 56 
+4.5 Organization ................................ ................................ ................................ ................................ ..... 56 
+4.5.1 User Management ................................ ................................ ................................ ................... 56 
+4.5.1.1 Inviting New User ................................ ................................ ................................ ................. 56 
+4.5.1.2 Delete User ................................ ................................ ................................ .......................... 57 
+4.5.2 Private Key Management ................................ ................................ ................................ ......... 57 
+4.5.3 Settings ................................ ................................ ................................ ................................ ..... 58 
+4.5.3.1 Timezone And License ................................ ................................ ................................ .......... 58 
+4.5.3.2 Alert Notifications ................................ ................................ ................................ ................ 59 
+4.5.4 Service Configuration ................................ ................................ ................................ ............... 62

pages/Chorus_R1.1_UserGuide_page_004.txt

@@ -0,0 +1,12 @@
+Page 4
+Document: Chorus R1.1 User Guide
+==================================================
+
+Ataya Proprietary and Confidential 4 CHORUS USER GUIDE 
+4.5.5 DNN Configuration ................................ ................................ ................................ ................... 63 
+4.5.6 Audit ................................ ................................ ................................ ................................ ......... 63 
+4.6 Help Center ................................ ................................ ................................ ................................ ...... 64 
+Appendix 1 Glossary ................................ ................................ ................................ ................................ .... 66 
+Appendix 2 DHCP Requirement ................................ ................................ ................................ .................. 68 
+Appendix 3 Concept of Zone ................................ ................................ ................................ ....................... 68 
+Appendix 4 DHCP Server Configuration Example (isc -DHCP) ................................ ................................ ...... 70

pages/Chorus_R1.1_UserGuide_page_005.txt

@@ -0,0 +1,44 @@
+Page 5
+Document: Chorus R1.1 User Guide
+==================================================
+
+Ataya Proprietary and Confidential 5 CHORUS USER GUIDE 
+Table of Figures 
+Figure 1 Chorus Architecture ................................ ................................ ................................ ........................... 11 
+Figure 2 Chorus invitation mail ................................ ................................ ................................ ........................ 12 
+Figure 3 Chorus first login password setup ................................ ................................ ................................ ...... 13 
+Figure 4 Chorus main page ................................ ................................ ................................ .............................. 13 
+Figure 5 Overview ................................ ................................ ................................ ................................ ............ 14 
+Figure 6 Network Statistics ................................ ................................ ................................ .............................. 16 
+Figure 7 Chorus Device Statistics ................................ ................................ ................................ ..................... 16 
+Figure 8 Device KPIs dashboard ................................ ................................ ................................ ....................... 17 
+Figure 9 Select desired KPI information ................................ ................................ ................................ ........... 17 
+Figure 10 A Mean KPI example  Channel Quality Indicator (CQI) ................................ ................................ .. 18 
+Figure 11 A Ratio KPI example -- UECNTX DRB Accessibility ................................ ................................ ........... 18 
+Figure 12 A Cumulative KPI example -- Total UL Data Volume Cumulative Measurements ............................ 18 
+Figure 13 Download CSV file for each KPI ................................ ................................ ................................ ........ 19 
+Figure 14 Client Statistics ................................ ................................ ................................ ................................ . 20 
+Figure 15 View Client Details ................................ ................................ ................................ ........................... 20 
+Figure 16 Client Details ................................ ................................ ................................ ................................ .... 21 
+Figure 17 De -register a client ................................ ................................ ................................ ........................... 21 
+Figure 18 Alerts  Active Alerts ................................ ................................ ................................ ........................ 22 
+Figure 19 Alerts  All Alerts ................................ ................................ ................................ .............................. 22 
+Figure 20 Alert Filter by gNB ID ................................ ................................ ................................ ........................ 23 
+Figure 21 Mouse Over the Details of An Alert to Read the Full Text ................................ ............................... 23 
+Figure 22 Show/Hide Columns Customization ................................ ................................ ................................ . 24 
+Figure 23 Device  Table View ................................ ................................ ................................ ......................... 25 
+Figure 24 Device Map view - outdoor ................................ ................................ ................................ .............. 26 
+Figure 25 Device Map view  indoor ................................ ................................ ................................ ............... 26 
+Figure 26 Outdoor/Indoor view switch ................................ ................................ ................................ ............ 26 
+Figure 27 Update Location Manually ................................ ................................ ................................ ............... 27 
+Figure 28 Input the Location Details ................................ ................................ ................................ ................ 27 
+Figure 29 choose to upload indoor site map ................................ ................................ ................................ ... 28 
+Figure 30 upload indoor site map ................................ ................................ ................................ .................... 28 
+Figure 31 more options for device ................................ ................................ ................................ ................... 29 
+Figure 32 Add a New Zone ................................ ................................ ................................ ............................... 29 
+Figure 33 Input Zone Detail ................................ ................................ ................................ .............................. 30 
+Figure 34 Edit an Existing Zone ................................ ................................ ................................ ........................ 31 
+Figure 35 Manage Neighbor List ................................ ................................ ................................ ...................... 31 
+Figure 36 Configure Neighbor List ................................ ................................ ................................ ................... 31 
+Figure 37 Delete an Existing Zone ................................ ................................ ................................ .................... 32 
+Figure 38 Add Chorus Device ................................ ................................ ................................ ........................... 32

pages/Chorus_R1.1_UserGuide_page_006.txt

@@ -0,0 +1,44 @@
+Page 6
+Document: Chorus R1.1 User Guide
+==================================================
+
+Ataya Proprietary and Confidential 6 CHORUS USER GUIDE 
+figure 39 Add Chorus Device ................................ ................................ ................................ ............................ 33 
+Figure 40 Device Serial Number and MAC information ................................ ................................ ................... 33 
+Figure 41 Upload Devices List in CSV file Format ................................ ................................ ............................. 34 
+Figure 42 Devices list shows successfully created Chorus device ................................ ................................ .... 34 
+Figure 43 Edit an Existing Device ................................ ................................ ................................ ..................... 35 
+Figure 44 Change Device name and select Zone ................................ ................................ ............................. 35 
+Figure 45 RF Parameters Configuration ................................ ................................ ................................ ........... 36 
+Figure 46 Static IP for N6 configuration ................................ ................................ ................................ ........... 37 
+Figure 47 Manage Devices License ................................ ................................ ................................ ................. 37 
+Figure 48 Assign or Delete a Devices License ................................ ................................ ................................ .. 38 
+Figure 49 Manage Neighbor List of a Device ................................ ................................ ................................ ... 38 
+Figure 50 Reboot a Device ................................ ................................ ................................ ............................... 39 
+Figure 51 Restart UPF ................................ ................................ ................................ ................................ ....... 39 
+Figure 52 Upload Log to Chorus ................................ ................................ ................................ ....................... 40 
+Figure 53 Delete a Device ................................ ................................ ................................ ................................ 40 
+Figure 54 Turn On/Off Radio ................................ ................................ ................................ ............................ 41 
+Figure 55 Details of a Device ................................ ................................ ................................ ............................ 41 
+Figure 56 Analytics for Traffic and Device uptime ................................ ................................ ........................... 42 
+Figure 57 Analytics for Clients Served ................................ ................................ ................................ .............. 42 
+Figure 58 Device Installation History ................................ ................................ ................................ ............... 42 
+Figure 59 Device Events ................................ ................................ ................................ ................................ ... 43 
+Figure 60 Upload 5G Client Credentials ................................ ................................ ................................ ........... 44 
+Figure 61 A single 5G client credential configuration ................................ ................................ ...................... 45 
+Figure 62 Configure the policies for the client ................................ ................................ ................................ . 46 
+Figure 63 Edit an Existing Client from Client List ................................ ................................ ............................. 47 
+Figure 64 Edit an Existing Client ................................ ................................ ................................ ....................... 47 
+Figure 65 Change assign / unassign status ................................ ................................ ................................ ....... 48 
+Figure 66 Block a client ................................ ................................ ................................ ................................ .... 48 
+Figure 67 Restore a Blocked Client ................................ ................................ ................................ ................... 48 
+Figure 68 Delete Client ................................ ................................ ................................ ................................ ..... 49 
+Figure 69 Policies ................................ ................................ ................................ ................................ ............. 50 
+Figure 70 A Policy creation example ................................ ................................ ................................ ................ 51 
+Figure 71 Configure bandwidth limit ................................ ................................ ................................ ............... 51 
+Figure 72 An example of application slicing configuration ................................ ................................ .............. 52 
+Figure 73 An example of an IP Filtering configuration ................................ ................................ ..................... 52 
+Figure 74 An example of client time schedule configuration ................................ ................................ .......... 53 
+Figure 75 Apply Policy to a Client ................................ ................................ ................................ ..................... 54 
+Figure 76 Choose a Policy to apply for a client ................................ ................................ ................................ 54 
+Figure 77 Clone a policy ................................ ................................ ................................ ................................ ... 55

pages/Chorus_R1.1_UserGuide_page_007.txt

@@ -0,0 +1,30 @@
+Page 7
+Document: Chorus R1.1 User Guide
+==================================================
+
+Ataya Proprietary and Confidential 7 CHORUS USER GUIDE 
+Figure 78 Set a Policy as Default ................................ ................................ ................................ ...................... 55 
+Figure 79 View Clients Assigned to a Policy ................................ ................................ ................................ ..... 56 
+Figure 80 Delete Policy ................................ ................................ ................................ ................................ ..... 56 
+Figure 81 Invite a New User ................................ ................................ ................................ ............................. 56 
+Figure 82 Limited Permission for a User with Role User ................................ ................................ .............. 57 
+Figure 83 Delete User ................................ ................................ ................................ ................................ ....... 57 
+Figure 84 Private Key Management ................................ ................................ ................................ ................. 58 
+Figure 85 Encrypt client signaling messages from 5GC ................................ ................................ ................... 58 
+Figure 86 License details ................................ ................................ ................................ ................................ .. 59 
+Figure 87 Webhooks Configuration to Publish Alerts ................................ ................................ ...................... 59 
+Figure 88 Configure to Send Alerts to a Specific Microsoft Teams group ................................ ........................ 60 
+Figure 89 Notifications can be sent to email addresses through the configured Email address .................... 60 
+Figure 90 Alert Notification with an Email entry configured ................................ ................................ ........... 61 
+Figure 91 Notifications can be sent via SMS to the configured Phone Number ................................ ............. 61 
+Figure 92 Alert Notification with SMS entry configured ................................ ................................ .................. 62 
+Figure 93 Service Configuration ................................ ................................ ................................ ....................... 63 
+Figure 94 Setup DNN in Chorus ................................ ................................ ................................ ....................... 63 
+Figure 95 Audit tab ................................ ................................ ................................ ................................ ........... 64 
+Figure 96 Audit details ................................ ................................ ................................ ................................ ..... 64 
+Figure 97 Help Center ................................ ................................ ................................ ................................ ...... 65 
+Figure 98 Help Center main page ................................ ................................ ................................ ..................... 65 
+Figure 99 Submit information ................................ ................................ ................................ .......................... 66 
+Figure 100 Chorus Zone  UE can reach another UE on different Chorus AP in Zone ................................ ..... 69 
+Figure 101 Chorus Zone  Chorus Zone with source NAT ................................ ................................ ................ 70 
+Figure 102 Example of isc -DHCP configuration ................................ ................................ ................................ 70

pages/Chorus_R1.1_UserGuide_page_008.txt

@@ -0,0 +1,8 @@
+Page 8
+Document: Chorus R1.1 User Guide
+==================================================
+
+Ataya Proprietary and Confidential 8 CHORUS USER GUIDE 
+Revision History 
+Version Contents Date 
+1.0 Initial Release April 10 , 2025

pages/Chorus_R1.1_UserGuide_page_009.txt

@@ -0,0 +1,9 @@
+Page 9
+Document: Chorus R1.1 User Guide
+==================================================
+
+Ataya Proprietary and Confidential 9 CHORUS USER GUIDE 
+1 Objective 
+This document provides a comprehensive overview of all the features of Ataya Chorus, with chapters 
+organized according to the Web GUI dashboard layout. If you have recently acquired a Chorus device and 
+need step -by-step instructions, please refer to the Chorus Quick Start Guide .

pages/Chorus_R1.1_UserGuide_page_010.txt

@@ -0,0 +1,33 @@
+Page 10
+Document: Chorus R1.1 User Guide
+==================================================
+
+Ataya Proprietary and Confidential 10 CHORUS USER GUIDE 
+2 Chorus AP 
+2.1 Brief Introduction 
+Private 5G solutions remain complex for small to medium -sized deployments. On -site installation of 
+hardware and software for the 5G Core and network integration into existing systems are challenging 
+tasks. Additionally, monitoring, troubleshooting, softwar e upgrades, and other maintenance activities add 
+to this complexity . 
+In many use cases, such as retail stores, gas stations, oil and gas operations, smart agriculture, and 
+emergency response systems, customers find the current 5G solutions overly burdensome. They are 
+looking for a simpler solution that reduces setup time and requires minimal on -site configuration. They 
+need a plug -and-play system where gNBs connect to the internet and provide instant 5G service. 
+It is essential to reduce operational complexity with a centralized cloud -managed dashboard for all remote 
+sites and to lower costs by eliminating the need for servers, switches, and other hardware. 
+Chorus AP is the perfect answer for this concern . It has been integrated with Chorus Agent , Chorus Data 
+Plane and the gNB. The key futures of Chorus AP are listed as follows : 
+ Deployment simplicity: 
+Experience true zero -touch deployment just plug in the Chorus AP, and it works. 
+ Data stays on -premises: 
+The Chorus data plane is contained within the Chorus AP. 
+ Simplified device onboarding: 
+ The multi -tenanted control plane is hosted in the cloud and automatically connects to the Chorus 
+AP on boot -up. 
+ Device onboarding is managed through a cloud management dashboard. 
+The target use cases are listed as follows : 
+ Enable quick point -to-point 5G connections in oil & gas, factory shop floors, vision -based use cases, 
+and more. 
+ Enterprise customers are looking to augment Wi -Fi with 5G, such as in parking lots or airports for 
+cameras, or for private networks in venues and stadiums. 
+ Ideal for small deployments of 1 to 5 nodes.

pages/Chorus_R1.1_UserGuide_page_011.txt

@@ -0,0 +1,7 @@
+Page 11
+Document: Chorus R1.1 User Guide
+==================================================
+
+Ataya Proprietary and Confidential 11 CHORUS USER GUIDE 
+ 
+Figure 1 Chorus Architecture

pages/Chorus_R1.1_UserGuide_page_012.txt

@@ -0,0 +1,16 @@
+Page 12
+Document: Chorus R1.1 User Guide
+==================================================
+
+Ataya Proprietary and Confidential 12 CHORUS USER GUIDE 
+3 Prerequisites 
+Chorus is designed for convenient deployment . There are only two prerequisites: 
+ Chorus Cloud account. 
+ Chorus Device 
+ 
+3.1 Chorus Cloud Account 
+To activate your account, check the invitation mail from Ataya Chorus . Click the ACCEPT INVITATION button 
+and you will be redirected to the Chorus page. Then you will be required to set a password with complexity. 
+Examples are shown as follows : 
+ 
+Figure 2 Chorus invitation mail

pages/Chorus_R1.1_UserGuide_page_013.txt

@@ -0,0 +1,14 @@
+Page 13
+Document: Chorus R1.1 User Guide
+==================================================
+
+Ataya Proprietary and Confidential 13 CHORUS USER GUIDE 
+ 
+Figure 3 Chorus first login password setup 
+Then you should see the main page (https://dashboard -chorus.ataya.io/dashboard ) of Chorus with your 
+successfully created account. Examples are as follows : 
+ 
+Figure 4 Chorus main page 
+3.2 Chorus Device 
+The Chorus Device refers to the hardware that had been integrated with Chorus Agent , Chorus Data Plane 
+and the gNB.

pages/Chorus_R1.1_UserGuide_page_014.txt

@@ -0,0 +1,27 @@
+Page 14
+Document: Chorus R1.1 User Guide
+==================================================
+
+Ataya Proprietary and Confidential 14 CHORUS USER GUIDE 
+4 Dashboard for Chorus 
+This section will explain each feature on Chorus in order, following the layout of the dashboard. 
+4.1 Insights & Analytics 
+The Insights & Analytics option on the top menu allows the operator to view summary level statistics. 
+Each of the sub -sections below describe the functionality of each of left -pane option under Insights and 
+Analytics 
+ 
+4.1.1 Overview 
+ 
+Figure 5 Overview 
+The Overview main page is broken down into multiple subsections: 
+ Alerts: 
+This shows the counts of critical and warning alerts during the last hour. A detailed list of all alerts 
+over longer time periods is available using the Alerts tab on the left sidebar. 
+ Network/Cluster Summary: 
+This section shows the number of active 5G clients and number of active Chorus Devices. 
+ Active Clients: 
+This section shows a list of active clients with information such as client name, acquired IP address, 
+last connection time and others. There are multiple filters, including DNN, gNB id and client ID that 
+can be used to focus on a subset of active client list . You can deregister a 5G client from 5G core 
+network by clicking on the target UE and then click on De-register . On the row of an active client, 
+you can click the 3 -dot action symbol and then click on Details, to see the full histo ry of the UE