diff --git a/.gitignore b/.gitignore
index fb1f532..bae3a3f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -9,8 +9,10 @@
# Archive directories
/tmp/
*.tar.gz
+!mubsat-deployment.tar.gz
*.zip
*.archive
+mubsat-deployment-temp/
# Python
__pycache__/
diff --git a/API-CONNECTION-GUIDE.md b/API-CONNECTION-GUIDE.md
new file mode 100644
index 0000000..1493055
--- /dev/null
+++ b/API-CONNECTION-GUIDE.md
@@ -0,0 +1,336 @@
+# ๐ ุฏููู ุงูุงุชุตุงู ุจุฎุงุฏู
API | API Connection Guide
+
+> **ุฏููู ุณุฑูุน ูููุตูู ูุฎุงุฏู
API ูุงููุงุฌูุงุช ูุงููู
ุงุฐุฌ**
+>
+> **Quick guide for accessing API server, interfaces, and models**
+
+---
+
+## ๐ ุงูุจุฏุก ุงูุณุฑูุน | Quick Start
+
+### ุงูุทุฑููุฉ ุงูุฃุณูู | Easiest Way
+
+```bash
+# ุงุณุชุฎุฏู
DEPLOY-NOW ู
ุน ุฎูุงุฑ --api
+# Use DEPLOY-NOW with --api option
+bash DEPLOY-NOW.sh --api
+```
+
+ุฃู | Or:
+
+```bash
+# ุงุณุชุฎุฏู
ุงูุณูุฑูุจุช ุงูู
ุฎุตุต ู
ุจุงุดุฑุฉ
+# Use the dedicated script directly
+bash connect-api-server.sh
+```
+
+---
+
+## ๐ ู
ุงุฐุง ูููุฑุ | What Does It Provide?
+
+### 1. ุงููุตูู ูููุงุฌูุงุช | Access to Interfaces
+
+ูููุฑ ุงููุตูู ูู | Provides access to:
+
+- **ุงููุงุฌูุฉ ุงูุฑุฆูุณูุฉ** | Main Interface (`index.html`)
+- **ุนุฑุถ OpenWebUI** | OpenWebUI Demo (`openwebui-demo.html`)
+- **ููุญุฉ ุงูุชุญูู
** | Dashboard Template (`openwebui-dashboard-template.html`)
+
+### 2. ุนุฑุถ ุงููู
ุงุฐุฌ | View Models
+
+ูุนุฑุถ ุฌู
ูุน ุงููู
ุงุฐุฌ ุงูู
ุชุงุญุฉ | Shows all available models:
+
+- โ
GPT-3.5 Turbo (OpenAI)
+- โ
GPT-4 (OpenAI)
+- โ
Claude 3 (Anthropic)
+- โ
LLaMA 3 (Meta)
+- โ
Qwen Arabic (Alibaba)
+- โ
AraBERT (AUB)
+- โ
Mistral (Mistral AI)
+- โ
DeepSeek Coder (DeepSeek)
+
+### 3. ุงุฎุชุจุงุฑ API | Test API
+
+ูุชูุญ ูู ุงุฎุชุจุงุฑ ุงูู API ู
ุจุงุดุฑุฉ | Allows you to test the API directly:
+
+- ุฅุฑุณุงู ุทูุจุงุช ุจุงูุนุฑุจูุฉ | Send Arabic requests
+- ุฅุฑุณุงู ุทูุจุงุช ุจุงูุฅูุฌููุฒูุฉ | Send English requests
+- ุงุฎุชุจุงุฑ ุงููู
ุงุฐุฌ ุงูู
ุฎุชููุฉ | Test different models
+
+---
+
+## ๐ฏ ุฎูุงุฑุงุช ุงูุงุณุชุฎุฏุงู
| Usage Options
+
+### ุงูุฎูุงุฑ 1: ู
ู ุฎูุงู DEPLOY-NOW.sh
+
+```bash
+# ุชุดุบูู ุชูุงุนูู | Interactive mode
+bash DEPLOY-NOW.sh
+
+# ุซู
ุงุฎุชุฑ | Then choose:
+# 4) ุฎุงุฏู
API ูุงููุงุฌูุงุช | API Server & Interfaces
+```
+
+ุฃู ู
ุจุงุดุฑุฉ | Or directly:
+
+```bash
+bash DEPLOY-NOW.sh --api
+```
+
+### ุงูุฎูุงุฑ 2: ุงูุณูุฑูุจุช ุงูู
ุฎุตุต
+
+```bash
+# ุงูุงุชุตุงู ุจุฎุงุฏู
ู
ุญูู | Connect to local server
+bash connect-api-server.sh
+
+# ุงูุงุชุตุงู ุจุฎุงุฏู
ุจุนูุฏ | Connect to remote server
+bash connect-api-server.sh http://your-server:5000
+```
+
+---
+
+## ๐ ูุงุฌูุฉ ุงูุณูุฑูุจุช | Script Interface
+
+ุนูุฏ ุชุดุบูู ุงูุณูุฑูุจุชุ ุณุชุญุตู ุนูู ูุงุฆู
ุฉ ุชูุงุนููุฉ | When running the script, you get an interactive menu:
+
+```
+๐ฏ ูุงุฆู
ุฉ ุงููุงุฌูุงุช | Interface Menu
+
+1) ุงููุตูู ูููุงุฌูุงุช | Access Web Interfaces
+ ูุชุญ ุงููุงุฌูุงุช ุงูุชูุงุนููุฉ
+
+2) ุนุฑุถ ุงููู
ุงุฐุฌ | View Models
+ ุนุฑุถ ุฌู
ูุน ุงููู
ุงุฐุฌ ุงูู
ุชุงุญุฉ
+
+3) ุงุฎุชุจุงุฑ API | Test API
+ ุฅุฑุณุงู ุทูุจ ุชุฌุฑูุจู
+
+4) ุชุดุบูู ุฎุงุฏู
API | Start API Server
+ ุชุดุบูู ุฎุงุฏู
API ู
ุญููุงู
+
+5) ุฎุฑูุฌ | Exit
+```
+
+---
+
+## ๐ง ุชุดุบูู ุฎุงุฏู
API ู
ุญููุงู | Starting API Server Locally
+
+### ุงูุทุฑููุฉ 1: ู
ู ุฎูุงู connect-api-server.sh
+
+```bash
+bash connect-api-server.sh
+# ุงุฎุชุฑ ุงูุฎูุงุฑ 4 | Choose option 4
+```
+
+### ุงูุทุฑููุฉ 2: ู
ุจุงุดุฑุฉ
+
+```bash
+cd api
+python3 server.py
+```
+
+ุณูุนู
ู ุงูุฎุงุฏู
ุนูู | Server will run on:
+```
+http://0.0.0.0:5000
+```
+
+---
+
+## ๐ ููุงุท ุงูููุงูุฉ ุงูู
ุชุงุญุฉ | Available Endpoints
+
+### 1. ูุญุต ุงูุตุญุฉ | Health Check
+```bash
+GET http://localhost:5000/api/health
+```
+
+**Response:**
+```json
+{
+ "status": "healthy",
+ "timestamp": "2025-11-06T04:00:00",
+ "service": "AI Agent Platform API"
+}
+```
+
+### 2. ุญุงูุฉ API | API Status
+```bash
+GET http://localhost:5000/api/status
+```
+
+**Response:**
+```json
+{
+ "status": "operational",
+ "models": [...],
+ "timestamp": "2025-11-06T04:00:00"
+}
+```
+
+### 3. ูุงุฆู
ุฉ ุงููู
ุงุฐุฌ | List Models
+```bash
+GET http://localhost:5000/api/models
+```
+
+**Response:**
+```json
+{
+ "models": [
+ {
+ "id": "gpt-3.5-turbo",
+ "name": "GPT-3.5 Turbo",
+ "provider": "OpenAI",
+ "type": "general"
+ },
+ ...
+ ]
+}
+```
+
+### 4. ู
ุนุงูุฌุฉ ุงูุฃูุงู
ุฑ | Process Commands
+```bash
+POST http://localhost:5000/api/process
+Content-Type: application/json
+
+{
+ "command": "ู
ุฑุญุจุงู",
+ "context": {
+ "model": "qwen-arabic",
+ "language": "ar"
+ }
+}
+```
+
+**Response:**
+```json
+{
+ "success": true,
+ "response": "ู
ุฑุญุจุงู! ุฃูุง qwen-arabic ูุฃูุง ููุง ูู
ุณุงุนุฏุชู...",
+ "model": "qwen-arabic",
+ "timestamp": "2025-11-06T04:00:00"
+}
+```
+
+---
+
+## ๐ ุงุฎุชุจุงุฑ ุณุฑูุน | Quick Test
+
+### ุงุฎุชุจุงุฑ ุงูุงุชุตุงู | Test Connection
+
+```bash
+curl http://localhost:5000/api/health
+```
+
+### ุงุฎุชุจุงุฑ ุจุงูุนุฑุจูุฉ | Test in Arabic
+
+```bash
+curl -X POST http://localhost:5000/api/process \
+ -H "Content-Type: application/json" \
+ -d '{
+ "command": "ู
ุฑุญุจุงู",
+ "context": {
+ "model": "qwen-arabic",
+ "language": "ar"
+ }
+ }'
+```
+
+### ุงุฎุชุจุงุฑ ุจุงูุฅูุฌููุฒูุฉ | Test in English
+
+```bash
+curl -X POST http://localhost:5000/api/process \
+ -H "Content-Type: application/json" \
+ -d '{
+ "command": "Hello",
+ "context": {
+ "model": "gpt-3.5-turbo",
+ "language": "en"
+ }
+ }'
+```
+
+---
+
+## ๐ ุงูุฃู
ุงู | Security
+
+### ุงูู
ุชุทูุจุงุช ุงูุฃุณุงุณูุฉ | Basic Requirements
+
+- โ
ุงูุฎุงุฏู
ูุนู
ู ุนูู `0.0.0.0` ููุจูู ุงูุงุชุตุงูุงุช ุงูุฎุงุฑุฌูุฉ
+- โ
ุงุณุชุฎุฏู
HTTPS ูู ุจูุฆุฉ ุงูุฅูุชุงุฌ
+- โ
ุฃุถู ู
ุตุงุฏูุฉ (Authentication) ููุฅูุชุงุฌ
+- โ
ุงุณุชุฎุฏู
CORS ุจุญุฐุฑ
+
+---
+
+## โ ุญู ุงูู
ุดุงูู | Troubleshooting
+
+### ุงูู
ุดููุฉ: ูุง ูู
ูู ุงูุงุชุตุงู ุจุงูุฎุงุฏู
+
+```bash
+# ุชุญูู ู
ู ุฃู ุงูุฎุงุฏู
ูุนู
ู | Check if server is running
+curl http://localhost:5000/api/health
+
+# ุชุญูู ู
ู ุงูู
ููุฐ | Check if port is open
+netstat -tuln | grep 5000
+
+# ุชุญูู ู
ู ุงูุฌุฏุงุฑ ุงููุงุฑู | Check firewall
+sudo ufw status
+```
+
+### ุงูู
ุดููุฉ: ุงูุฎุงุฏู
ูุง ูุจุฏุฃ
+
+```bash
+# ุชุญูู ู
ู ุชุซุจูุช ุงูู
ุชุทูุจุงุช | Check requirements installed
+pip3 install -r requirements.txt
+
+# ุชุญูู ู
ู Python | Check Python version
+python3 --version
+
+# ุดุบูู ู
ุน debug | Run with debug
+cd api && python3 server.py
+```
+
+### ุงูู
ุดููุฉ: ุงููุงุฌูุงุช ูุง ุชูุชุญ
+
+```bash
+# ุงูุชุญ ูุฏููุงู | Open manually
+firefox index.html
+# ุฃู | or
+google-chrome index.html
+# ุฃู | or
+open index.html # macOS
+```
+
+---
+
+## ๐ ุงูู
ุฒูุฏ ู
ู ุงูุชูุซูู | More Documentation
+
+- ๐ [README.md](README.md) - ุงูุฏููู ุงููุงู
ู
+- ๐ [START-HERE.md](START-HERE.md) - ุงูุจุฏุก ุงูุณุฑูุน
+- ๐ [DEPLOYMENT.md](DEPLOYMENT.md) - ุฏููู ุงููุดุฑ
+- ๐ [DOCUMENTATION-INDEX.md](DOCUMENTATION-INDEX.md) - ููุฑุณ ุดุงู
ู
+
+---
+
+## ๐ก ูุตุงุฆุญ | Tips
+
+### ููู
ุทูุฑูู | For Developers
+
+- ุงุณุชุฎุฏู
`--api` ููุชุทููุฑ ุงูุณุฑูุน
+- ุฑุงูุจ ุงูุณุฌูุงุช ูู ูุญุฏุฉ ุงูุชุญูู
+- ุงุณุชุฎุฏู
Postman ุฃู curl ูุงุฎุชุจุงุฑ ุงูู API
+
+### ููู
ุณุชุฎุฏู
ูู | For Users
+
+- ุงุณุชุฎุฏู
ุงููุงุฌูุงุช ุงูุชูุงุนููุฉ ูุณูููุฉ ุงูุงุณุชุฎุฏุงู
+- ุฌุฑุจ ุงููู
ุงุฐุฌ ุงูู
ุฎุชููุฉ ูุฅูุฌุงุฏ ุงูุฃูุถู
+- ุงุญูุธ ุนููุงู URL ููุฎุงุฏู
ูููุตูู ุงูุณุฑูุน
+
+---
+
+
+
+**ุตููุน ุจู โค๏ธ ููู
ุฌุชู
ุน ุงูุนุฑุจู ูุงูุนุงูู
ู**
+
+**Made with โค๏ธ for the Arabic and Global Community**
+
+
diff --git a/DEPLOY-NOW.sh b/DEPLOY-NOW.sh
new file mode 100755
index 0000000..e7b042f
--- /dev/null
+++ b/DEPLOY-NOW.sh
@@ -0,0 +1,611 @@
+#!/bin/bash
+
+#############################################################################
+# DEPLOY-NOW.sh - ุงูุณูุฑูุจุช ุงูุฑุฆูุณู ูููุดุฑ ุงูุชููุงุฆู
+# Main Automatic Deployment Script for AI Agent Platform
+#
+# Description: Universal deployment script with support for:
+# - Automatic environment detection
+# - Multiple deployment targets (Local, VPS, GitHub Pages)
+# - Interactive and non-interactive modes
+# - Complete validation and health checks
+#
+# Usage: bash DEPLOY-NOW.sh [options]
+# Options:
+# --auto : Automatic mode (no prompts)
+# --local : Deploy locally only
+# --vps : Deploy to VPS
+# --github : Deploy to GitHub Pages
+# --help : Show help message
+#############################################################################
+
+set -euo pipefail # Stricter error handling: exit on error, undefined variable, or failed pipeline
+
+# Version
+VERSION="1.0.0"
+
+# Color codes for beautiful output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+PURPLE='\033[0;35m'
+CYAN='\033[0;36m'
+WHITE='\033[1;37m'
+NC='\033[0m' # No Color
+
+# Deployment configuration
+DEPLOYMENT_MODE="auto"
+TARGET=""
+PROJECT_NAME="AI Agent Platform"
+PROJECT_DIR=$(pwd)
+
+#############################################################################
+# Display Functions
+#############################################################################
+
+print_banner() {
+ clear
+ echo -e "${PURPLE}โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ${NC}"
+ echo -e "${PURPLE}โ${NC} ${PURPLE}โ${NC}"
+ echo -e "${PURPLE}โ${NC} ${CYAN}๐ AI Agent Platform - Deployment System ๐${NC} ${PURPLE}โ${NC}"
+ echo -e "${PURPLE}โ${NC} ${CYAN}ู
ูุตุฉ ูููู ุงูุฐูุงุก ุงูุงุตุทูุงุนู - ูุธุงู
ุงููุดุฑ${NC} ${PURPLE}โ${NC}"
+ echo -e "${PURPLE}โ${NC} ${PURPLE}โ${NC}"
+ echo -e "${PURPLE}โ${NC} ${WHITE}Version: ${VERSION}${NC} ${PURPLE}โ${NC}"
+ echo -e "${PURPLE}โ${NC} ${PURPLE}โ${NC}"
+ echo -e "${PURPLE}โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ${NC}"
+ echo ""
+}
+
+print_section() {
+ echo ""
+ echo -e "${BLUE}โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ${NC}"
+ echo -e "${CYAN} $1${NC}"
+ echo -e "${BLUE}โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ${NC}"
+ echo ""
+}
+
+print_success() {
+ echo -e "${GREEN}โ${NC} $1"
+}
+
+print_error() {
+ echo -e "${RED}โ${NC} $1"
+}
+
+print_warning() {
+ echo -e "${YELLOW}โ ${NC} $1"
+}
+
+print_info() {
+ echo -e "${BLUE}โน${NC} $1"
+}
+
+print_step() {
+ echo -e "${PURPLE}โถ${NC} $1"
+}
+
+#############################################################################
+# Helper Functions
+#############################################################################
+
+show_help() {
+ cat << EOF
+${GREEN}DEPLOY-NOW.sh${NC} - Universal Deployment Script
+
+${CYAN}Usage:${NC}
+ bash DEPLOY-NOW.sh [options]
+
+${CYAN}Options:${NC}
+ --auto Automatic deployment (no prompts)
+ --local Deploy locally only
+ --vps Deploy to VPS server
+ --github Deploy to GitHub Pages
+ --api API server & interfaces only
+ --help Show this help message
+
+${CYAN}Examples:${NC}
+ bash DEPLOY-NOW.sh # Interactive mode
+ bash DEPLOY-NOW.sh --auto # Automatic deployment
+ bash DEPLOY-NOW.sh --local # Local deployment only
+ bash DEPLOY-NOW.sh --vps # VPS deployment
+ bash DEPLOY-NOW.sh --api # API & interfaces access
+
+${CYAN}Environment Variables:${NC}
+ VPS_HOST VPS server hostname or IP
+ VPS_USER VPS username (default: root)
+ VPS_PORT SSH port (default: 22)
+
+${CYAN}Documentation:${NC}
+ README.md Complete project guide
+ START-HERE.md Quick start guide
+ DEPLOYMENT.md Detailed deployment guide
+ GITHUB-DOWNLOAD.txt Download instructions
+
+${GREEN}Made with โค๏ธ for the Community${NC}
+EOF
+ exit 0
+}
+
+check_command() {
+ if command -v "$1" &> /dev/null; then
+ print_success "$1 is installed"
+ return 0
+ else
+ print_warning "$1 is not installed"
+ return 1
+ fi
+}
+
+#############################################################################
+# System Checks
+#############################################################################
+
+check_system_requirements() {
+ print_section "๐ ูุญุต ู
ุชุทูุจุงุช ุงููุธุงู
| Checking System Requirements"
+
+ local all_ok=true
+
+ # Essential tools
+ print_step "Checking essential tools..."
+
+ if check_command "bash"; then
+ BASH_VERSION_NUM=$(bash --version | head -n1 | sed -n 's/.*version \([0-9]*\.[0-9]*\).*/\1/p')
+ print_info "Bash version: $BASH_VERSION_NUM"
+ else
+ all_ok=false
+ fi
+
+ if check_command "git"; then
+ GIT_VERSION=$(git --version | sed -n 's/git version \([0-9]*\.[0-9]*\.[0-9]*\).*/\1/p')
+ print_info "Git version: $GIT_VERSION"
+ else
+ print_warning "Git is recommended for version control"
+ fi
+
+ if check_command "python3"; then
+ PYTHON_VERSION=$(python3 --version | sed -n 's/Python \([0-9]*\.[0-9]*\.[0-9]*\).*/\1/p')
+ print_info "Python version: $PYTHON_VERSION"
+ else
+ print_error "Python 3 is required!"
+ all_ok=false
+ fi
+
+ if check_command "pip3" || check_command "pip"; then
+ PIP_VERSION=$(pip3 --version 2>/dev/null || pip --version | sed -n 's/pip \([0-9]*\.[0-9]*\.[0-9]*\).*/\1/p' | head -1)
+ print_info "Pip version: $PIP_VERSION"
+ else
+ print_error "Pip is required!"
+ all_ok=false
+ fi
+
+ # Optional but recommended tools
+ print_step "Checking optional tools..."
+ check_command "curl" || true
+ check_command "wget" || true
+ check_command "docker" || true
+ check_command "docker-compose" || true
+
+ # Check disk space
+ print_step "Checking disk space..."
+ AVAILABLE_SPACE=$(df -h . | awk 'NR==2 {print $4}')
+ print_info "Available disk space: $AVAILABLE_SPACE"
+
+ # Check memory
+ if command -v free &> /dev/null; then
+ TOTAL_MEM=$(free -h | awk 'NR==2 {print $2}')
+ AVAILABLE_MEM=$(free -h | awk 'NR==2 {print $7}')
+ print_info "Total memory: $TOTAL_MEM, Available: $AVAILABLE_MEM"
+ fi
+
+ echo ""
+ if [ "$all_ok" = true ]; then
+ print_success "All essential requirements are met!"
+ return 0
+ else
+ print_error "Some requirements are missing. Please install them first."
+ echo ""
+ print_info "Quick install commands:"
+ echo " Ubuntu/Debian: sudo apt-get update && sudo apt-get install -y python3 python3-pip git"
+ echo " CentOS/RHEL: sudo yum install -y python3 python3-pip git"
+ echo " macOS: brew install python3 git"
+ echo ""
+ return 1
+ fi
+}
+
+#############################################################################
+# Environment Setup
+#############################################################################
+
+setup_environment() {
+ print_section "โ๏ธ ุฅุนุฏุงุฏ ุงูุจูุฆุฉ | Setting Up Environment"
+
+ print_step "Checking for .env file..."
+ if [ ! -f ".env" ]; then
+ if [ -f ".env.example" ]; then
+ print_warning ".env file not found, creating from .env.example"
+ cp .env.example .env
+ print_success ".env file created"
+ print_warning "Please edit .env file and add your API keys!"
+ echo ""
+ print_info "Required API keys:"
+ echo " - OPENROUTER_API_KEY: Get from https://openrouter.ai/"
+ echo " - Add any other required keys"
+ echo ""
+ read -p "Press Enter after you've configured .env file..."
+ else
+ print_warning ".env.example not found, creating basic .env"
+ cat > .env << 'EOF'
+# AI Agent Platform Environment Configuration
+# Configure these values before deployment
+
+# OpenRouter API Configuration
+OPENROUTER_API_KEY=your_api_key_here
+
+# Server Configuration
+PORT=5000
+HOST=0.0.0.0
+
+# Environment
+ENVIRONMENT=production
+
+# Debug Mode (set to false in production)
+DEBUG=false
+EOF
+ print_success "Basic .env file created"
+ print_warning "Please edit .env and add your API keys!"
+ read -p "Press Enter after configuration..."
+ fi
+ else
+ print_success ".env file exists"
+ fi
+
+ # Install Python dependencies
+ print_step "Installing Python dependencies..."
+ if [ -f "requirements.txt" ]; then
+ if ! pip3 install -q -r requirements.txt 2>&1 | grep -v "already satisfied"; then
+ print_warning "Some packages may already be installed or installation had warnings"
+ fi
+ print_success "Python dependencies installed"
+ else
+ print_warning "requirements.txt not found, installing basic packages"
+ if ! pip3 install -q flask flask-cors requests; then
+ print_error "Failed to install basic packages"
+ exit 1
+ fi
+ print_success "Basic packages installed"
+ fi
+
+ # Create necessary directories
+ print_step "Creating necessary directories..."
+ mkdir -p logs backups temp
+ print_success "Directories created"
+
+ echo ""
+ print_success "Environment setup complete!"
+}
+
+#############################################################################
+# Deployment Functions
+#############################################################################
+
+deploy_local() {
+ print_section "๐ป ูุดุฑ ู
ุญูู | Local Deployment"
+
+ print_step "Starting local deployment..."
+
+ # Check if Flask app exists
+ if [ -f "api/app.py" ] || [ -f "app.py" ]; then
+ print_info "Flask application found"
+
+ # Find the app file
+ if [ -f "api/app.py" ]; then
+ APP_FILE="api/app.py"
+ else
+ APP_FILE="app.py"
+ fi
+
+ print_step "Starting Flask server..."
+ echo ""
+ print_success "Server will start at http://localhost:5000"
+ print_info "Available endpoints:"
+ echo " - GET /api/health - Health check"
+ echo " - GET /api/status - Status information"
+ echo " - POST /api/process - Process requests"
+ echo ""
+ print_warning "Press Ctrl+C to stop the server"
+ echo ""
+
+ # Start the server
+ export FLASK_APP="$APP_FILE"
+ export FLASK_ENV=production
+ python3 -m flask run --host=0.0.0.0 --port=5000
+ else
+ print_warning "Flask application not found, starting simple HTTP server"
+
+ if [ -f "index.html" ]; then
+ print_info "Starting Python HTTP server..."
+ echo ""
+ print_success "Server will start at http://localhost:8000"
+ print_warning "Press Ctrl+C to stop the server"
+ echo ""
+ python3 -m http.server 8000
+ else
+ print_error "No application files found!"
+ return 1
+ fi
+ fi
+}
+
+deploy_vps() {
+ print_section "๐ ูุดุฑ ุนูู VPS | VPS Deployment"
+
+ # Check if VPS configuration exists
+ if [ -z "$VPS_HOST" ]; then
+ print_warning "VPS_HOST not configured"
+ read -p "Enter VPS hostname or IP: " VPS_HOST
+ export VPS_HOST
+ fi
+
+ if [ -z "$VPS_USER" ]; then
+ VPS_USER="root"
+ fi
+
+ if [ -z "$VPS_PORT" ]; then
+ VPS_PORT="22"
+ fi
+
+ print_info "VPS Configuration:"
+ echo " Host: $VPS_HOST"
+ echo " User: $VPS_USER"
+ echo " Port: $VPS_PORT"
+ echo ""
+
+ # Test SSH connection
+ print_step "Testing SSH connection..."
+ SSH_ERROR=$(ssh -o ConnectTimeout=5 -o StrictHostKeyChecking=yes -p "$VPS_PORT" "$VPS_USER@$VPS_HOST" "echo 'Connection successful'" 2>&1)
+ if [ $? -eq 0 ]; then
+ print_success "SSH connection successful"
+ else
+ print_error "Cannot connect to VPS via SSH"
+ echo "$SSH_ERROR"
+ print_info "Please check:"
+ echo " 1. VPS is running and accessible"
+ echo " 2. SSH keys are configured"
+ echo " 3. Firewall allows SSH connections"
+ echo " 4. Host key is verified (check ~/.ssh/known_hosts)"
+ return 1
+ fi
+
+ # Check if deploy script exists
+ if [ -f "deploy.sh" ]; then
+ print_step "Running comprehensive deployment script..."
+ chmod +x deploy.sh
+ ./deploy.sh
+ else
+ print_step "Copying files to VPS..."
+ rsync -avz -e "ssh -p \"$VPS_PORT\"" \
+ --exclude='.git' \
+ --exclude='node_modules' \
+ --exclude='__pycache__' \
+ --exclude='*.pyc' \
+ --exclude='.env' \
+ --exclude='.env.*' \
+ --exclude='*.bak' \
+ --exclude='*.backup' \
+ --exclude='.env.local' \
+ ./ "$VPS_USER@$VPS_HOST:/var/www/ai-agent-platform/"
+
+ print_success "Files copied successfully"
+
+ print_step "Setting up environment on VPS..."
+ ssh -p "$VPS_PORT" "$VPS_USER@$VPS_HOST" << 'ENDSSH'
+cd /var/www/ai-agent-platform
+pip3 install -r requirements.txt
+sudo systemctl restart ai-agent-platform || echo "Service not configured"
+ENDSSH
+
+ print_success "VPS deployment complete!"
+ fi
+}
+
+deploy_github_pages() {
+ print_section "๐ ูุดุฑ ุนูู GitHub Pages | GitHub Pages Deployment"
+
+ if [ ! -d ".git" ]; then
+ print_error "Not a git repository!"
+ print_info "Initialize git first: git init"
+ return 1
+ fi
+
+ print_step "Checking GitHub Pages status..."
+
+ # Check if index.html exists
+ if [ ! -f "index.html" ]; then
+ print_error "index.html not found!"
+ print_info "GitHub Pages requires an index.html file"
+ return 1
+ fi
+
+ print_success "index.html found"
+
+ print_step "Committing changes..."
+ git add .
+ git commit -m "Deploy: $(date '+%Y-%m-%d %H:%M:%S')" || print_warning "No changes to commit"
+
+ print_step "Pushing to GitHub..."
+ git push origin main || git push origin master
+
+ print_success "GitHub Pages deployment complete!"
+ print_info "Your site will be available at:"
+ echo " https://$(git remote get-url origin | sed 's/.*github.com[:\/]//' | sed 's/.git$//' | sed 's/\//github.io\//')"
+}
+
+#############################################################################
+# Main Deployment Menu
+#############################################################################
+
+show_deployment_menu() {
+ print_section "๐ ูุงุฆู
ุฉ ุงููุดุฑ | Deployment Menu"
+
+ echo -e "${CYAN}ุงุฎุชุฑ ุฎูุงุฑ ุงููุดุฑ | Choose deployment option:${NC}"
+ echo ""
+ echo " 1) ${GREEN}ูุดุฑ ู
ุญูู${NC} | Local Deployment"
+ echo " ุชุดุบูู ุนูู ุฌูุงุฒู ุงูู
ุญูู Start on your local machine"
+ echo ""
+ echo " 2) ${BLUE}ูุดุฑ ุนูู VPS${NC} | VPS Deployment"
+ echo " ูุดุฑ ุนูู ุฎุงุฏู
VPS Deploy to VPS server"
+ echo ""
+ echo " 3) ${PURPLE}ูุดุฑ ุนูู GitHub Pages${NC} | GitHub Pages"
+ echo " ูุดุฑ ู
ููุน ุซุงุจุช Deploy static website"
+ echo ""
+ echo " 4) ${CYAN}ุฎุงุฏู
API ูุงููุงุฌูุงุช${NC} | API Server & Interfaces"
+ echo " ุงููุตูู ูููู
ุงุฐุฌ ูุงููุงุฌูุงุช Access models and interfaces"
+ echo ""
+ echo " 5) ${YELLOW}ูุดุฑ ูุงู
ู${NC} | Full Deployment"
+ echo " ูุดุฑ ุนูู ุฌู
ูุน ุงูู
ูุตุงุช Deploy to all platforms"
+ echo ""
+ echo " 6) ${WHITE}ุงุฎุชุจุงุฑ ุงููุธุงู
${NC} | System Test"
+ echo " ุงุฎุชุจุงุฑ ุงูุจูุฆุฉ ููุท Test environment only"
+ echo ""
+ echo " 7) ${RED}ุฎุฑูุฌ${NC} | Exit"
+ echo ""
+
+ read -p "$(echo -e ${CYAN}Enter your choice [1-7]:${NC} )" choice
+
+ case $choice in
+ 1)
+ deploy_local
+ ;;
+ 2)
+ deploy_vps
+ ;;
+ 3)
+ deploy_github_pages
+ ;;
+ 4)
+ # API Server & Interfaces
+ if [ -f "connect-api-server.sh" ]; then
+ chmod +x connect-api-server.sh
+ ./connect-api-server.sh
+ else
+ print_error "connect-api-server.sh not found!"
+ print_info "Running API server directly..."
+ deploy_local
+ fi
+ ;;
+ 5)
+ print_info "Starting full deployment..."
+ print_warning "Note: Local server will not be started in background for full deployment"
+ print_info "Deploy locally separately if you need a running server"
+ # deploy_local runs a blocking server, so we skip it in full deployment
+ # Users should run it separately if they need a local server
+ deploy_vps
+ deploy_github_pages
+ print_success "Full deployment complete!"
+ print_info "To start local server: bash DEPLOY-NOW.sh --local"
+ ;;
+ 6)
+ check_system_requirements
+ setup_environment
+ print_success "System test complete!"
+ ;;
+ 7)
+ print_info "Exiting..."
+ exit 0
+ ;;
+ *)
+ print_error "Invalid choice!"
+ show_deployment_menu
+ ;;
+ esac
+}
+
+#############################################################################
+# Main Program
+#############################################################################
+
+main() {
+ # Parse command line arguments
+ while [[ $# -gt 0 ]]; do
+ case $1 in
+ --help|-h)
+ show_help
+ ;;
+ --auto)
+ DEPLOYMENT_MODE="auto"
+ shift
+ ;;
+ --local)
+ TARGET="local"
+ shift
+ ;;
+ --vps)
+ TARGET="vps"
+ shift
+ ;;
+ --github)
+ TARGET="github"
+ shift
+ ;;
+ --api)
+ TARGET="api"
+ shift
+ ;;
+ *)
+ print_error "Unknown option: $1"
+ echo "Use --help for usage information"
+ exit 1
+ ;;
+ esac
+ done
+
+ # Show banner
+ print_banner
+
+ # System checks
+ check_system_requirements || exit 1
+
+ # Setup environment
+ setup_environment
+
+ # Execute deployment based on mode
+ if [ -n "$TARGET" ]; then
+ case $TARGET in
+ local)
+ deploy_local
+ ;;
+ vps)
+ deploy_vps
+ ;;
+ github)
+ deploy_github_pages
+ ;;
+ api)
+ if [ -f "connect-api-server.sh" ]; then
+ chmod +x connect-api-server.sh
+ ./connect-api-server.sh
+ else
+ print_error "connect-api-server.sh not found!"
+ exit 1
+ fi
+ ;;
+ esac
+ else
+ # Interactive mode
+ show_deployment_menu
+ fi
+
+ echo ""
+ print_section "๐ ุงููุดุฑ ู
ูุชู
ู | Deployment Complete"
+ print_success "Thank you for using AI Agent Platform!"
+ print_info "For support, visit: https://github.com/wasalstor-web/AI-Agent-Platform"
+ echo ""
+}
+
+# Trap Ctrl+C
+trap 'echo ""; print_warning "Deployment interrupted"; exit 130' INT
+
+# Run main program
+main "$@"
diff --git a/DOCUMENTATION-INDEX.md b/DOCUMENTATION-INDEX.md
new file mode 100644
index 0000000..f93c756
--- /dev/null
+++ b/DOCUMENTATION-INDEX.md
@@ -0,0 +1,300 @@
+# ๐ ููุฑุณ ุงููุซุงุฆู | Documentation Index
+
+> **ุฏููู ุดุงู
ู ูุฌู
ูุน ุงูู
ููุงุช ูุงููุซุงุฆู ูู ุงูู
ุดุฑูุน**
+>
+> **Complete Guide to All Files and Documentation in the Project**
+
+---
+
+## ๐ ููุจุฏุก ุงูุณุฑูุน | Quick Start
+
+### 1๏ธโฃ ุฃูู ู
ุฑุฉ ููุงุ | First Time Here?
+
+ุงุจุฏุฃ ุจูุฐุง ุงูุชุฑุชูุจ | Start with this order:
+
+```
+START-HERE.md โ DEPLOY-NOW.sh โ README.md
+```
+
+### 2๏ธโฃ ู
ููุงุช ุงูุจุฏุงูุฉ ุงูุฃุณุงุณูุฉ | Essential Starting Files
+
+| # | ุงูู
ูู | ุงูุญุฌู
| ุงูุฃููููุฉ | ุงููุตู |
+|---|------|------|---------|-------|
+| โญ | **[START-HERE.md](START-HERE.md)** | 3.7KB | **ุนุงููุฉ ุฌุฏุงู** | ุฃุจุณุท ุฏููู ููุจุฏุก - ุงุจุฏุฃ ู
ู ููุง! |
+| ๐ | **[DEPLOY-NOW.sh](DEPLOY-NOW.sh)** | 18KB | **ุนุงููุฉ ุฌุฏุงู** | ุณูุฑูุจุช ุงููุดุฑ ุงูุฑุฆูุณู - ุดุบูู ู
ุจุงุดุฑุฉ! |
+| ๐ฅ | **[GITHUB-DOWNLOAD.txt](GITHUB-DOWNLOAD.txt)** | 13KB | **ุนุงููุฉ** | 5 ุทุฑู ูุชุญู
ูู ุงูู
ุดุฑูุน |
+| ๐ฆ | **[mubsat-deployment.tar.gz](mubsat-deployment.tar.gz)** | 44KB | **ุนุงููุฉ** | ุญุฒู
ุฉ ูุงู
ูุฉ ู
ุถุบูุทุฉ |
+
+---
+
+## ๐ ุงููุซุงุฆู ุงูุฑุฆูุณูุฉ | Main Documentation
+
+### ุฃุฏูุฉ ุงููุฑุงุกุฉ ุงูุฃุณุงุณูุฉ | Essential Reading Guides
+
+| ุงูู
ูู | ุงูุญุฌู
| ู
ุชู ุชูุฑุฃู | ุงููุตู ุงูุชูุตููู |
+|------|------|-----------|----------------|
+| **[README.md](README.md)** | 24KB | ุจุนุฏ ุงูุจุฏุก ุงูุณุฑูุน | ุงูุฏููู ุงูุฑุณู
ู ุงููุงู
ู ููู
ุดุฑูุน |
+| **[DEPLOYMENT.md](DEPLOYMENT.md)** | 12KB | ุนูุฏ ุงููุดุฑ | ุฏููู ุงููุดุฑ ุงูุชูุตููู ุนูู ุฌู
ูุน ุงูู
ูุตุงุช |
+| **[QUICK-START.md](QUICK-START.md)** | 2.7KB | ููุจุฏุงูุฉ ุงูุณุฑูุนุฉ | ุฏููู ุงูุจุฏุก ุงูุณุฑูุน ุงูู
ุฎุชุตุฑ |
+| **[STATUS.md](STATUS.md)** | 6.5KB | ูู
ุนุฑูุฉ ุงูุญุงูุฉ | ุญุงูุฉ ุงูู
ุดุฑูุน ุงูุญุงููุฉ ูุงูู
ูุฒุงุช |
+
+---
+
+## ๐ ุณูุฑูุจุชุงุช ุงููุดุฑ | Deployment Scripts
+
+### ุงูุณูุฑูุจุชุงุช ุงูุฑุฆูุณูุฉ | Main Scripts
+
+| ุงูุณูุฑูุจุช | ุงูุญุฌู
| ุงูุงุณุชุฎุฏุงู
| ุงููุตู |
+|---------|------|----------|-------|
+| **[DEPLOY-NOW.sh](DEPLOY-NOW.sh)** โญ | 18KB | `bash DEPLOY-NOW.sh` | ุงูุณูุฑูุจุช ุงูุดุงู
ู - ุงูุฃูุถู ููุฌู
ูุน |
+| **[complete-deployment.sh](complete-deployment.sh)** | 20KB | `bash complete-deployment.sh` | ูุดุฑ ุดุงู
ู ูู
ุชูุงู
ู |
+| **[autonomous-deploy.sh](autonomous-deploy.sh)** | 16KB | `bash autonomous-deploy.sh` | ูุดุฑ ู
ุณุชูู ุชููุงุฆู |
+| **[quick-start.sh](quick-start.sh)** | 6.3KB | `bash quick-start.sh` | ุจุฏุก ุณุฑูุน ููุชุทููุฑ ุงูู
ุญูู |
+| **[smart-deploy.sh](smart-deploy.sh)** | 4.4KB | `bash smart-deploy.sh` | ูุดุฑ ุฐูู ุชูุงุนูู |
+
+### ุณูุฑูุจุชุงุช ู
ุชุฎุตุตุฉ | Specialized Scripts
+
+| ุงูุณูุฑูุจุช | ุงูุญุฌู
| ุงููุฏู | ุงูุงุณุชุฎุฏุงู
|
+|---------|------|-------|----------|
+| **[setup-openwebui.sh](setup-openwebui.sh)** | 17KB | OpenWebUI | ุฅุนุฏุงุฏ ูุชุดุบูู OpenWebUI |
+| **[quick-deploy-openwebui.sh](quick-deploy-openwebui.sh)** | 16KB | OpenWebUI | ูุดุฑ ุณุฑูุน ูู OpenWebUI |
+| **[deploy.sh](deploy.sh)** | 14KB | VPS | ูุดุฑ ุนูู VPS ู
ุน ูุญูุตุงุช |
+| **[deploy-to-hostinger.sh](deploy-to-hostinger.sh)** | 781B | Hostinger | ูุดุฑ ุนูู Hostinger VPS |
+| **[setup-hostinger.sh](setup-hostinger.sh)** | 5.0KB | Hostinger | ุฅุนุฏุงุฏ ุฎุงุฏู
Hostinger |
+
+### ุณูุฑูุจุชุงุช ุงูุฅุฏุงุฑุฉ | Management Scripts
+
+| ุงูุณูุฑูุจุช | ุงูุญุฌู
| ุงูุบุฑุถ |
+|---------|------|-------|
+| **[check-status.sh](check-status.sh)** | 3.2KB | ูุญุต ุญุงูุฉ ุงููุดุฑ |
+| **[ai-agent-manager.sh](ai-agent-manager.sh)** | 8.5KB | ุฅุฏุงุฑุฉ ูููุงุก ุงูุฐูุงุก ุงูุงุตุทูุงุนู |
+| **[finalize_project.sh](finalize_project.sh)** | 7.3KB | ุฅููุงุก ูุฅุนุฏุงุฏ ุงูู
ุดุฑูุน |
+| **[validate-dlplus.sh](validate-dlplus.sh)** | 6.5KB | ุงูุชุญูู ู
ู ูุธุงู
DL+ |
+| **[start-dlplus.sh](start-dlplus.sh)** | 3.3KB | ุชุดุบูู ูุธุงู
DL+ |
+
+---
+
+## ๐ ุงูุฃุฏูุฉ ุงูุชูุตูููุฉ | Detailed Guides
+
+### ุฃุฏูุฉ ุงูุชุทููุฑ ูุงููุดุฑ | Development & Deployment Guides
+
+| ุงูุฏููู | ุงูุญุฌู
| ุงูู
ูุถูุน |
+|-------|------|---------|
+| **[AUTONOMOUS_DEPLOYMENT.md](AUTONOMOUS_DEPLOYMENT.md)** | 16KB | ุงููุดุฑ ุงูู
ุณุชูู ุงูุชููุงุฆู |
+| **[QUICK_DEPLOY_GUIDE.md](QUICK_DEPLOY_GUIDE.md)** | 9.8KB | ุฏููู ุงููุดุฑ ุงูุณุฑูุน |
+| **[DOMAIN_SETUP_GUIDE.md](DOMAIN_SETUP_GUIDE.md)** | 15KB | ุฅุนุฏุงุฏ ุงููุทุงู ูุงูุฏูู
ูู |
+| **[QUICK_ACCESS_GUIDE.md](QUICK_ACCESS_GUIDE.md)** | 7.5KB | ุงููุตูู ุงูุณุฑูุน ููุฎุฏู
ุงุช |
+| **[QUICK_REFERENCE.md](QUICK_REFERENCE.md)** | 6.0KB | ู
ุฑุฌุน ุณุฑูุน ููุฃูุงู
ุฑ |
+
+### ุฃุฏูุฉ ุงูุชูุงู
ู | Integration Guides
+
+| ุงูุฏููู | ุงูุญุฌู
| ุงูู
ูุถูุน |
+|-------|------|---------|
+| **[OPENWEBUI_INTEGRATION.md](OPENWEBUI_INTEGRATION.md)** | 10.7KB | ุชูุงู
ู OpenWebUI |
+| **[OPENWEBUI.md](OPENWEBUI.md)** | 15.7KB | ุฏููู OpenWebUI ุงููุงู
ู |
+| **[DLPLUS_DEPLOYMENT.md](DLPLUS_DEPLOYMENT.md)** | 11.3KB | ูุดุฑ ูุธุงู
DL+ |
+| **[DLPLUS_README.md](DLPLUS_README.md)** | 9.8KB | ุฏููู ูุธุงู
DL+ |
+| **[GITHUB_INTEGRATION_GUIDE.md](GITHUB_INTEGRATION_GUIDE.md)** | 1.9KB | ุชูุงู
ู GitHub |
+
+### ุชูุงุฑูุฑ ุงูุชูููุฐ | Implementation Reports
+
+| ุงูุชูุฑูุฑ | ุงูุญุฌู
| ุงูู
ุญุชูู |
+|---------|------|---------|
+| **[COMPREHENSIVE_FINAL_REPORT.md](COMPREHENSIVE_FINAL_REPORT.md)** | 15KB | ุงูุชูุฑูุฑ ุงูููุงุฆู ุงูุดุงู
ู |
+| **[IMPLEMENTATION_COMPLETE.md](IMPLEMENTATION_COMPLETE.md)** | 14KB | ุชูุฑูุฑ ุงูุชู
ุงู ุงูุชูููุฐ |
+| **[FINALIZATION_REPORT.md](FINALIZATION_REPORT.md)** | 12.7KB | ุชูุฑูุฑ ุงูุฅููุงุก |
+| **[FINALIZATION.md](FINALIZATION.md)** | 7.4KB | ูุซููุฉ ุงูุฅููุงุก |
+| **[PROJECT_COMPLETE.txt](PROJECT_COMPLETE.txt)** | 6.6KB | ุฅุนูุงู ุงูุชู
ุงู ุงูู
ุดุฑูุน |
+
+### ุฃุฏูุฉ ู
ุชุฎุตุตุฉ | Specialized Guides
+
+| ุงูุฏููู | ุงูุญุฌู
| ุงูู
ูุถูุน |
+|-------|------|---------|
+| **[ACCESSIBILITY.md](ACCESSIBILITY.md)** | 9.7KB | ุฅู
ูุงููุฉ ุงููุตูู |
+| **[ACCESSIBILITY_IMPLEMENTATION_SUMMARY.md](ACCESSIBILITY_IMPLEMENTATION_SUMMARY.md)** | 14.6KB | ู
ูุฎุต ุชูููุฐ ุฅู
ูุงููุฉ ุงููุตูู |
+| **[CHAT_INTERFACE.md](CHAT_INTERFACE.md)** | 11.3KB | ูุงุฌูุฉ ุงูุฏุฑุฏุดุฉ |
+| **[USAGE_EXAMPLE.md](USAGE_EXAMPLE.md)** | 11.6KB | ุฃู
ุซูุฉ ุงูุงุณุชุฎุฏุงู
|
+| **[HOSTINGER_COMMAND_EXECUTION.md](HOSTINGER_COMMAND_EXECUTION.md)** | 13.7KB | ุชูููุฐ ุฃูุงู
ุฑ Hostinger |
+
+---
+
+## โ๏ธ ู
ููุงุช ุงูุชูููู | Configuration Files
+
+| ุงูู
ูู | ุงูุญุฌู
| ุงูุบุฑุถ |
+|------|------|-------|
+| **[.env.example](.env.example)** | 858B | ู
ุซุงู ู
ูู ุงูุจูุฆุฉ ุงูุฃุณุงุณู |
+| **[.env.dlplus.example](.env.dlplus.example)** | 1.9KB | ู
ุซุงู ุจูุฆุฉ ูุธุงู
DL+ |
+| **[.env.instant-deploy.example](.env.instant-deploy.example)** | 2.3KB | ู
ุซุงู ุจูุฆุฉ ุงููุดุฑ ุงูููุฑู |
+| **[.env.openwebui](.env.openwebui)** | 1.6KB | ุชูููู OpenWebUI |
+| **[requirements.txt](requirements.txt)** | 752B | ู
ุชุทูุจุงุช Python |
+
+---
+
+## ๐ ู
ููุงุช Python | Python Files
+
+### ุณูุฑูุจุชุงุช Python ุงูุฑุฆูุณูุฉ | Main Python Scripts
+
+| ุงูู
ูู | ุงูุญุฌู
| ุงููุธููุฉ |
+|------|------|---------|
+| **[openwebui-integration.py](openwebui-integration.py)** | 14.2KB | ุชูุงู
ู OpenWebUI |
+| **[test_accessibility.py](test_accessibility.py)** | 9.0KB | ุงุฎุชุจุงุฑ ุฅู
ูุงููุฉ ุงููุตูู |
+| **[openwebui-connector.py](openwebui-connector.py)** | 2.3KB | ู
ูุตู OpenWebUI |
+| **[github-webhook-handler.py](github-webhook-handler.py)** | 1.0KB | ู
ุนุงูุฌ GitHub Webhooks |
+| **[github-commander.py](github-commander.py)** | 1.2KB | ูุงุฆุฏ GitHub |
+
+---
+
+## ๐ ู
ููุงุช ุงูููุจ | Web Files
+
+| ุงูู
ูู | ุงูุญุฌู
| ุงููุตู |
+|------|------|-------|
+| **[index.html](index.html)** | 63KB | ุงููุงุฌูุฉ ุงูุฑุฆูุณูุฉ ููููุจ |
+| **[openwebui-demo.html](openwebui-demo.html)** | 12.5KB | ุนุฑุถ ุชูุถูุญู ูู OpenWebUI |
+| **[openwebui-dashboard-template.html](openwebui-dashboard-template.html)** | 6.3KB | ูุงูุจ ููุญุฉ ุชุญูู
OpenWebUI |
+
+---
+
+## ๐ ุงูู
ุฌูุฏุงุช | Directories
+
+| ุงูู
ุฌูุฏ | ุงูู
ุญุชูู |
+|--------|---------|
+| **[api/](api/)** | ู
ููุงุช API ูุงูุฎุงุฏู
|
+| **[dlplus/](dlplus/)** | ูุธุงู
DL+ Intelligence |
+| **[docs/](docs/)** | ูุซุงุฆู ุฅุถุงููุฉ |
+| **[examples/](examples/)** | ุฃู
ุซูุฉ ูุญุงูุงุช ุงุณุชุฎุฏุงู
|
+| **[scripts/](scripts/)** | ุณูุฑูุจุชุงุช ู
ุณุงุนุฏุฉ |
+| **[tests/](tests/)** | ู
ููุงุช ุงูุงุฎุชุจุงุฑ |
+| **[.github/](.github/)** | ุชููููุงุช GitHub Actions |
+
+---
+
+## ๐ฏ ุฎุงุฑุทุฉ ุงูุทุฑูู | Roadmap
+
+### ููู
ุณุชุฎุฏู
ูู ุงูุฌุฏุฏ | For New Users
+
+```
+1. ูุฑุงุกุฉ START-HERE.md
+ โ
+2. ุชุดุบูู DEPLOY-NOW.sh
+ โ
+3. ูุฑุงุกุฉ README.md ููููู
ุงูุดุงู
ู
+ โ
+4. ุงุณุชูุดุงู ุงูู
ูุฒุงุช
+```
+
+### ููู
ุทูุฑูู | For Developers
+
+```
+1. ูุฑุงุกุฉ README.md
+ โ
+2. ูุฑุงุกุฉ DEPLOYMENT.md
+ โ
+3. ูุญุต ุงูุณูุฑูุจุชุงุช ูู ุงูู
ุดุฑูุน
+ โ
+4. ูุฑุงุกุฉ ุงูุชูุงุฑูุฑ ุงูุชูููุฉ
+ โ
+5. ุงูุจุฏุก ูู ุงูุชุทููุฑ
+```
+
+### ูู
ุณุคููู ุงูุฃูุธู
ุฉ | For System Administrators
+
+```
+1. ูุฑุงุกุฉ DEPLOYMENT.md
+ โ
+2. ูุญุต ุณูุฑูุจุชุงุช ุงููุดุฑ
+ โ
+3. ุฅุนุฏุงุฏ ุงูุจูุฆุฉ (.env files)
+ โ
+4. ุชุดุบูู ุงูุงุฎุชุจุงุฑุงุช
+ โ
+5. ุงููุดุฑ ุนูู ุงูุฅูุชุงุฌ
+```
+
+---
+
+## ๐ ุงูุจุญุซ ุงูุณุฑูุน | Quick Search
+
+### ุฃุญุชุงุฌ ุฅูู... | I Need to...
+
+| ุงููุฏู | ุงูู
ูู ุงูู
ูุงุณุจ |
+|-------|---------------|
+| ๐ **ุงูุจุฏุก ููุฑุงู** | START-HERE.md + DEPLOY-NOW.sh |
+| ๐ฅ **ุชุญู
ูู ุงูู
ุดุฑูุน** | GITHUB-DOWNLOAD.txt |
+| ๐ **ุงููุดุฑ ุนูู VPS** | deploy.sh + DEPLOYMENT.md |
+| ๐ป **ุงูุชุทููุฑ ุงูู
ุญูู** | quick-start.sh |
+| ๐ง **ุฅุนุฏุงุฏ OpenWebUI** | setup-openwebui.sh + OPENWEBUI.md |
+| ๐ **ููู
ุงูู
ุดุฑูุน** | README.md + STATUS.md |
+| ๐ **ุญู ุงูู
ุดุงูู** | QUICK_REFERENCE.md |
+| ๐ **ุชูููู ุงูุจูุฆุฉ** | .env.example |
+| ๐ฆ **ุญุฒู
ุฉ ูุงู
ูุฉ** | mubsat-deployment.tar.gz |
+
+---
+
+## ๐ ุงูุฅุญุตุงุฆูุงุช | Statistics
+
+```
+๐ ุฅุฌู
ุงูู ุงูู
ููุงุช: 138 ู
ูู
+๐ฆ ุณูุฑูุจุชุงุช ุงููุดุฑ: 23 ุณูุฑูุจุช
+๐ ุงููุซุงุฆู ูุงูุฃุฏูุฉ: 36 ุฏููู
+โ๏ธ ู
ููุงุช ุงูุชูููู: 5 ู
ููุงุช
+๐ ุณูุฑูุจุชุงุช Python: 8 ู
ููุงุช
+๐ ู
ููุงุช HTML: 3 ู
ููุงุช
+๐พ ุงูุญุฌู
ุงูุฅุฌู
ุงูู: ~1.8 MB
+๐ฆ ุญุฌู
ุงูุญุฒู
ุฉ ุงูู
ุถุบูุทุฉ: 44 KB
+```
+
+---
+
+## ๐ก ูุตุงุฆุญ ู
ูู
ุฉ | Important Tips
+
+### โ
ุฃูุถู ุงูู
ู
ุงุฑุณุงุช | Best Practices
+
+1. **ุงุจุฏุฃ ุฏุงุฆู
ุงู ุจู START-HERE.md** - ูููู
ุงูุฃุณุงุณูุงุช
+2. **ุงุณุชุฎุฏู
DEPLOY-NOW.sh** - ูููุดุฑ ุงูุณุฑูุน ูุงูู
ูุซูู
+3. **ุงูุฑุฃ README.md ุจุงููุงู
ู** - ูููู
ุดุงู
ู ููู
ุดุฑูุน
+4. **ุชุญูู ู
ู .env.example** - ูุจู ุงููุดุฑ
+5. **ุงุณุชุฎุฏู
mubsat-deployment.tar.gz** - ููุชูุฒูุน ุงูุณุฑูุน
+
+### โ ๏ธ ุชุญุฐูุฑุงุช | Warnings
+
+- โ ูุง ุชุดุงุฑู ู
ููุงุช `.env` ุงูุญููููุฉ
+- โ ูุง ุชูุดุฑ ุจุฏูู ุงุฎุชุจุงุฑ ู
ุญูู ุฃููุงู
+- โ ูุง ุชุชุฌุงูู ุงููุญูุตุงุช ุงูุฃู
ููุฉ
+- โ
ุงุญุชูุธ ุจูุณุฎ ุงุญุชูุงุทูุฉ ุฏุงุฆู
ุงู
+- โ
ุงูุฑุฃ ุงูุชูุซูู ูุจู ุชุนุฏูู ุงูุณูุฑูุจุชุงุช
+
+---
+
+## ๐ ุงูุญุตูู ุนูู ุงูู
ุณุงุนุฏุฉ | Getting Help
+
+### ุงูุชุฑุชูุจ ุงูู
ูุตู ุจู | Recommended Order
+
+1. ๐ **ุงุจุญุซ ูู ูุฐุง ุงูููุฑุณ** - ูุฏ ุชุฌุฏ ุงูุฅุฌุงุจุฉ ู
ุจุงุดุฑุฉ
+2. ๐ **ุงูุฑุฃ ุงููุซุงุฆู ุฐุงุช ุงูุตูุฉ** - ุงูู
ุฐููุฑุฉ ูู ุงูููุฑุณ
+3. ๐ **ุงุจุญุซ ูู GitHub Issues** - ูุฏ ูููู ููุงู ุญู ู
ูุฌูุฏ
+4. โ **ุงูุชุญ Issue ุฌุฏูุฏ** - ุฅุฐุง ูู
ุชุฌุฏ ุญูุงู
+5. ๐ฌ **ุชูุงุตู ู
ุน ุงูู
ุฌุชู
ุน** - ูู ุตูุญุฉ Discussions
+
+### ุฑูุงุจุท ู
ููุฏุฉ | Useful Links
+
+- ๐ **ุงูู
ููุน**: https://wasalstor-web.github.io/AI-Agent-Platform/
+- ๐ **GitHub**: https://github.com/wasalstor-web/AI-Agent-Platform
+- ๐ **Issues**: https://github.com/wasalstor-web/AI-Agent-Platform/issues
+
+---
+
+
+
+## ๐ ู
ุจุฑูู!
+
+**ุงูุขู ูุฏูู ุฎุงุฑุทุฉ ูุงู
ูุฉ ูุฌู
ูุน ู
ููุงุช ุงูู
ุดุฑูุน!**
+
+**Now you have a complete map of all project files!**
+
+---
+
+**ุตููุน ุจู โค๏ธ ููู
ุฌุชู
ุน ุงูุนุฑุจู ูุงูุนุงูู
ู**
+
+**Made with โค๏ธ for the Arabic and Global Community**
+
+
diff --git a/GITHUB-DOWNLOAD.txt b/GITHUB-DOWNLOAD.txt
new file mode 100644
index 0000000..0937942
--- /dev/null
+++ b/GITHUB-DOWNLOAD.txt
@@ -0,0 +1,260 @@
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+ ุฏููู ุชุญู
ูู ุงูู
ุดุฑูุน ู
ู GitHub
+ GitHub Download Guide for AI Agent Platform
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+
+๐ฅ ููู ุชุญู
ูู ูุฐุง ุงูู
ุดุฑูุนุ
+๐ฅ How to Download This Project?
+
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+๐ฏ ุงูุทุฑููุฉ 1: Git Clone (ุงูุฃูุถู ูุงูุฃุณุฑุน)
+๐ฏ Method 1: Git Clone (Best & Fastest)
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+
+ุงูุฎุทูุงุช | Steps:
+
+1. ุงูุชุญ Terminal ุฃู Command Prompt
+ Open Terminal or Command Prompt
+
+2. ูููุฐ ูุฐุง ุงูุฃู
ุฑ:
+ Execute this command:
+
+ git clone https://github.com/wasalstor-web/AI-Agent-Platform.git
+
+3. ุงุฏุฎู ููู
ุฌูุฏ:
+ Enter the folder:
+
+ cd AI-Agent-Platform
+
+4. ุงุจุฏุฃ ุงูุงุณุชุฎุฏุงู
:
+ Start using:
+
+ bash DEPLOY-NOW.sh
+
+โ
ุงูู
ู
ูุฒุงุช | Advantages:
+ โข ุณุฑูุน ุฌุฏุงู | Very fast
+ โข ูู
ููู ุงูุชุญุฏูุซ ุจุณูููุฉ (git pull) | Easy updates
+ โข ูุญูุธ ุชุงุฑูุฎ ุงูู
ุดุฑูุน | Preserves project history
+ โข ุงูุฃูุถู ููู
ุทูุฑูู | Best for developers
+
+โ ุงูู
ุชุทูุจุงุช | Requirements:
+ โข Git ูุฌุจ ุฃู ูููู ู
ุซุจุช | Git must be installed
+ โข ุงุชุตุงู ุฅูุชุฑูุช | Internet connection
+
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+๐ฏ ุงูุทุฑููุฉ 2: ุชุญู
ูู ZIP (ุจุฏูู Git)
+๐ฏ Method 2: Download ZIP (Without Git)
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+
+ุงูุฎุทูุงุช | Steps:
+
+1. ุงุฐูุจ ููุฑุงุจุท:
+ Go to the link:
+ https://github.com/wasalstor-web/AI-Agent-Platform
+
+2. ุงููุฑ ุนูู ุงูุฒุฑ ุงูุฃุฎุถุฑ "Code"
+ Click the green "Code" button
+
+3. ุงุฎุชุฑ "Download ZIP"
+ Choose "Download ZIP"
+
+4. ุจุนุฏ ุงูุชุญู
ููุ ูู ุงูุถุบุท:
+ After download, extract:
+
+ ุนูู Windows: ุงููุฑ ูู
ูู > Extract All
+ On Windows: Right-click > Extract All
+
+ ุนูู Linux/Mac:
+ On Linux/Mac:
+ unzip AI-Agent-Platform-main.zip
+ cd AI-Agent-Platform-main
+
+5. ุงุจุฏุฃ ุงูุงุณุชุฎุฏุงู
:
+ Start using:
+ bash DEPLOY-NOW.sh
+
+โ
ุงูู
ู
ูุฒุงุช | Advantages:
+ โข ูุง ูุญุชุงุฌ Git | Doesn't need Git
+ โข ุจุณูุท ุฌุฏุงู | Very simple
+ โข ู
ูุงุณุจ ููู
ุจุชุฏุฆูู | Good for beginners
+
+โ ุงูุนููุจ | Disadvantages:
+ โข ูู ุชุณุชุทูุน ุงุณุชุฎุฏุงู
git pull ููุชุญุฏูุซ
+ โข You won't be able to use git pull for updates
+
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+๐ฏ ุงูุทุฑููุฉ 3: ุชุญู
ูู ุงูุญุฒู
ุฉ ุงูู
ุถุบูุทุฉ (tar.gz)
+๐ฏ Method 3: Download Compressed Package (tar.gz)
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+
+ุงูุฎุทูุงุช | Steps:
+
+1. ุญู
ูู ุงูุญุฒู
ุฉ ู
ุจุงุดุฑุฉ:
+ Download the package directly:
+
+ wget https://github.com/wasalstor-web/AI-Agent-Platform/raw/main/mubsat-deployment.tar.gz
+
+ ุฃู | Or:
+
+ curl -L -O https://github.com/wasalstor-web/AI-Agent-Platform/raw/main/mubsat-deployment.tar.gz
+
+2. ูู ุงูุถุบุท:
+ Extract:
+
+ tar -xzf mubsat-deployment.tar.gz
+
+3. ุงุฏุฎู ููู
ุฌูุฏ:
+ Enter folder:
+
+ cd AI-Agent-Platform
+
+4. ุงุจุฏุฃ ุงูุงุณุชุฎุฏุงู
:
+ Start using:
+
+ bash DEPLOY-NOW.sh
+
+โ
ุงูู
ู
ูุฒุงุช | Advantages:
+ โข ุญุฌู
ุฃุตุบุฑ (ู
ุถุบูุท) | Smaller size (compressed)
+ โข ูู ุงูู
ููุงุช ุงูุฃุณุงุณูุฉ ููุท | Only essential files
+ โข ุณุฑูุน ุงูุชุญู
ูู | Fast download
+
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+๐ฏ ุงูุทุฑููุฉ 4: ุชุญู
ูู ุฅุตุฏุงุฑ ู
ุญุฏุฏ (Release)
+๐ฏ Method 4: Download Specific Release
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+
+ุงูุฎุทูุงุช | Steps:
+
+1. ุงุฐูุจ ูุตูุญุฉ ุงูุฅุตุฏุงุฑุงุช:
+ Go to releases page:
+ https://github.com/wasalstor-web/AI-Agent-Platform/releases
+
+2. ุงุฎุชุฑ ุงูุฅุตุฏุงุฑ ุงูู
ุทููุจ
+ Choose the desired version
+
+3. ุญู
ูู ู
ูู Source code (zip) ุฃู (tar.gz)
+ Download Source code (zip) or (tar.gz)
+
+4. ูู ุงูุถุบุท ูุงุจุฏุฃ ุงูุงุณุชุฎุฏุงู
+ Extract and start using
+
+โ
ุงูู
ู
ูุฒุงุช | Advantages:
+ โข ุฅุตุฏุงุฑุงุช ู
ุณุชูุฑุฉ | Stable versions
+ โข ู
ูุซููุฉ ูู
ุฎุชุจุฑุฉ | Reliable and tested
+
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+๐ฏ ุงูุทุฑููุฉ 5: ุงุณุชุฎุฏุงู
GitHub CLI
+๐ฏ Method 5: Using GitHub CLI
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+
+ุงูุฎุทูุงุช | Steps:
+
+1. ุชุซุจูุช GitHub CLI (ุฅู ูู
ููู ู
ุซุจุชุงู):
+ Install GitHub CLI (if not installed):
+ https://cli.github.com/
+
+2. ูููุฐ ุงูุฃู
ุฑ:
+ Execute command:
+
+ gh repo clone wasalstor-web/AI-Agent-Platform
+
+3. ุงุฏุฎู ููู
ุฌูุฏ ูุงุจุฏุฃ:
+ Enter folder and start:
+
+ cd AI-Agent-Platform
+ bash DEPLOY-NOW.sh
+
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+๐ ู
ูุงุฑูุฉ ุงูุทุฑู | Methods Comparison
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+
+ุงูุทุฑููุฉ | ุงูุณุฑุนุฉ | ุงูุณูููุฉ | ุงูุชุญุฏูุซ | ุงูุญุฌู
| ููู
ุทูุฑูู
+Method | Speed | Easy | Update | Size | For Devs
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+Git Clone | โ
โ
โ
โ
โ
| โ
โ
โ
โ
โ | โ
โ
โ
โ
โ
| 100% | โ
โ
โ
โ
โ
+Download ZIP | โ
โ
โ
โ
โ | โ
โ
โ
โ
โ
| โ
โโโโ | 100% | โ
โ
โโโ
+tar.gz Package | โ
โ
โ
โ
โ
| โ
โ
โ
โ
โ | โ
โโโโ | 50% | โ
โ
โ
โโ
+Release Version | โ
โ
โ
โ
โ | โ
โ
โ
โ
โ
| โ
โ
โโโ | 100% | โ
โ
โ
โโ
+GitHub CLI | โ
โ
โ
โ
โ
| โ
โ
โ
โโ | โ
โ
โ
โ
โ
| 100% | โ
โ
โ
โ
โ
+
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+โ ุญู ุงูู
ุดุงูู | Troubleshooting
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+
+๐ด ู
ุดููุฉ: git: command not found
+Problem: git: command not found
+
+ุงูุญู | Solution:
+โโโโโโโโโโโโโ
+Ubuntu/Debian: sudo apt-get install git
+CentOS/RHEL: sudo yum install git
+macOS: brew install git
+Windows: Download from https://git-scm.com/
+
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+
+๐ด ู
ุดููุฉ: ุงูุชุญู
ูู ุจุทูุก
+Problem: Slow download
+
+ุงูุญู | Solution:
+โโโโโโโโโโโโโ
+โข ุงุณุชุฎุฏู
mirror ูู ุจูุฏู | Use a mirror in your country
+โข ุงุณุชุฎุฏู
VPN ุฅุฐุง ูุงู ู
ุญุธูุฑุงู | Use VPN if blocked
+โข ุงุณุชุฎุฏู
tar.gz (ุญุฌู
ุฃุตุบุฑ) | Use tar.gz (smaller size)
+
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+
+๐ด ู
ุดููุฉ: ูุง ุฃุณุชุทูุน ูู ุงูุถุบุท
+Problem: Cannot extract
+
+ุงูุญู | Solution:
+โโโโโโโโโโโโโ
+Linux/Mac:
+ zip file: unzip filename.zip
+ tar.gz: tar -xzf filename.tar.gz
+
+Windows:
+ ุงุณุชุฎุฏู
7-Zip ุฃู WinRAR
+ Use 7-Zip or WinRAR
+
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+๐ฏ ุงูุชูุตูุงุช | Recommendations
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+
+ููู
ุทูุฑูู | For Developers:
+ ๐ ุงุณุชุฎุฏู
Git Clone
+ ๐ Use Git Clone
+
+ููู
ุจุชุฏุฆูู | For Beginners:
+ ๐ ุงุณุชุฎุฏู
Download ZIP
+ ๐ Use Download ZIP
+
+ููุณุฑุนุฉ | For Speed:
+ ๐ ุงุณุชุฎุฏู
tar.gz Package
+ ๐ Use tar.gz Package
+
+ููุงุณุชูุฑุงุฑ | For Stability:
+ ๐ ุงุณุชุฎุฏู
Release Version
+ ๐ Use Release Version
+
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+๐ ุงูุฏุนู
| Support
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+
+ุฅุฐุง ูุงุฌูุช ู
ุดููุฉ | If you face an issue:
+
+1. ุงูุฑุฃ START-HERE.md
+2. ุงูุฑุฃ README.md
+3. ุงุจุญุซ ูู Issues: https://github.com/wasalstor-web/AI-Agent-Platform/issues
+4. ุงูุชุญ Issue ุฌุฏูุฏ ุฅุฐุง ูู
ุชุฌุฏ ุญู
+
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+
+โ
ุชู
ุงูุชุญู
ููุ ุงูุขู ุดุบูู:
+โ
Downloaded? Now run:
+
+ bash DEPLOY-NOW.sh
+
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+ุตููุน ุจู โค๏ธ | Made with โค๏ธ
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
diff --git a/README.md b/README.md
index fecab52..3eb9442 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,61 @@
[](https://www.python.org/)
[](https://fastapi.tiangolo.com/)
+## โก ุงูุจุฏุก ุงูุณุฑูุน | Quick Start
+
+**ููู
ุณุชุฎุฏู
ูู ุงูุฌุฏุฏ** | **For New Users**: ุงุจุฏุฃ ู
ู ููุง โ Start here โ
+
+```bash
+# 1. ุญู
ูู ุงูู
ุดุฑูุน | Download the project
+git clone https://github.com/wasalstor-web/AI-Agent-Platform.git
+cd AI-Agent-Platform
+
+# 2. ูููุฐ ุณูุฑูุจุช ุงููุดุฑ | Run deployment script
+bash DEPLOY-NOW.sh
+```
+
+**ูุฐุง ูู ุดูุก!** ๐ ุงูุจุฑูุงู
ุฌ ุณูุชููู ุงูุจุงูู ุชููุงุฆูุงู!
+
+**That's it!** ๐ The script will handle everything automatically!
+
+### ๐ ู
ููุงุช ู
ูู
ุฉ | Important Files
+
+| ุงูู
ูู | ุงูุญุฌู
| ุงููุตู | Description |
+|------|------|-------|-------------|
+| ๐ [**START-HERE.md**](START-HERE.md) | 3.7KB | **ุงุจุฏุฃ ู
ู ููุง** - ุฃุจุณุท ุฏููู ููุจุฏุก ุงูุณุฑูุน | **Start Here** - Simplest quick start guide |
+| ๐ [**DEPLOY-NOW.sh**](DEPLOY-NOW.sh) | 18KB | ุงูุณูุฑูุจุช ุงูุฑุฆูุณู ูููุดุฑ ุงูุชููุงุฆู | Main automatic deployment script |
+| ๐ [**connect-api-server.sh**](connect-api-server.sh) | 6KB | **ุฌุฏูุฏ!** ุงุชุตุงู ุจุฎุงุฏู
API ูุงููุงุฌูุงุช | **New!** API server & interfaces connection |
+| ๐ [**GITHUB-DOWNLOAD.txt**](GITHUB-DOWNLOAD.txt) | 13KB | 5 ุทุฑู ูุชุญู
ูู ุงูู
ุดุฑูุน | 5 ways to download the project |
+| ๐ฆ [**mubsat-deployment.tar.gz**](mubsat-deployment.tar.gz) | 44KB | ุญุฒู
ุฉ ู
ุถุบูุทุฉ ุจูู ุดูุก | Compressed package with everything |
+| ๐ **README.md** | (ูุฐุง ุงูู
ูู) | ุงูุฏููู ุงููุงู
ู ููู
ุดุฑูุน | Complete project guide |
+| ๐ [**DEPLOYMENT.md**](DEPLOYMENT.md) | 12KB | ุฏููู ุงููุดุฑ ุงูุชูุตููู | Detailed deployment guide |
+| ๐ [**API-CONNECTION-GUIDE.md**](API-CONNECTION-GUIDE.md) | 6KB | **ุฌุฏูุฏ!** ุฏููู ุงูุงุชุตุงู ุจู API | **New!** API connection guide |
+
+### ๐ฏ ุงูุฎูุงุฑุงุช ุงูุณุฑูุนุฉ | Quick Options
+
+```bash
+# ูุดุฑ ู
ุญูู | Local deployment
+bash DEPLOY-NOW.sh --local
+
+# ูุดุฑ ุนูู VPS | VPS deployment
+bash DEPLOY-NOW.sh --vps
+
+# ูุดุฑ ุนูู GitHub Pages
+bash DEPLOY-NOW.sh --github
+
+# ุงููุตูู ูุฎุงุฏู
API ูุงููุงุฌูุงุช | API server & interfaces access
+bash DEPLOY-NOW.sh --api
+
+# ูุดุฑ ุชููุงุฆู ูุงู
ู | Full automatic deployment
+bash DEPLOY-NOW.sh --auto
+```
+
+**๐ก ูุตูุญุฉ**: ุฅุฐุง ูุงูุช ูุฐู ุฃูู ู
ุฑุฉุ ุงูุฑุฃ [START-HERE.md](START-HERE.md) ุฃููุงู!
+
+**๐ก Tip**: If this is your first time, read [START-HERE.md](START-HERE.md) first!
+
+---
+
## ๐ ู
ูุฏู
ุฉ | Introduction
**AI Agent Platform** ุนุจุงุฑุฉ ุนู ูุธุงู
ุฐูุงุก ุงุตุทูุงุนู ู
ุณุชูู ูู
ุชุทูุฑ ูุนู
ู ุจุงููุงู
ู ุนุจุฑ GitHub Actionsุ ู
ู
ุง ูููุฑ ุจูุฆุฉ ูููุฉ ูุจูุงุก ููุดุฑ ูุฅุฏุงุฑุฉ ุงููููุงุก ุงูุฃุฐููุงุก (AI Agents) ุงููุงุฏุฑูู ุนูู ุงูุชูููุฑ ุงูู
ูุทููุ ูุงุฎุชูุงุฑ ุงูุฃุฏูุงุช ุงูู
ูุงุณุจุฉุ ูุชูููุฐ ุงูู
ูุงู
ุงูู
ุนูุฏุฉ ุจุดูู ุฐุงุชู.
@@ -449,6 +504,63 @@ AI-Agent-Platform ยฉ 2025
---
+## ๐ ุฅุญุตุงุฆูุงุช ุงูู
ุดุฑูุน | Project Statistics
+
+### ๐ฆ ู
ููุงุช ุงูู
ุดุฑูุน | Project Files
+
+```
+๐ ุฅุฌู
ุงูู ุงูู
ููุงุช | Total Files: 138 files
+๐ฆ ุณูุฑูุจุชุงุช ุงููุดุฑ | Deployment Scripts: 23 scripts
+๐ ุงููุซุงุฆู ูุงูุฃุฏูุฉ | Documentation: 36 guides
+โ๏ธ ู
ููุงุช ุงูุชูููู | Configuration: 5 files
+๐พ ุงูุญุฌู
ุงูุฅุฌู
ุงูู | Total Size: ~1.8 MB
+```
+
+### ๐ ุงูุณูุฑูุจุชุงุช ุงูุฑุฆูุณูุฉ | Main Scripts
+
+| # | ุงูุณูุฑูุจุช | ุงูุญุฌู
| ุงููุตู |
+|---|---------|------|-------|
+| 1๏ธโฃ | **DEPLOY-NOW.sh** | 18KB | โญ ุงูุณูุฑูุจุช ุงูุฑุฆูุณู ูููุดุฑ ุงูุชููุงุฆู |
+| 2๏ธโฃ | **complete-deployment.sh** | 20KB | ูุดุฑ ุดุงู
ู ูู
ุชูุงู
ู |
+| 3๏ธโฃ | **autonomous-deploy.sh** | 16KB | ูุดุฑ ู
ุณุชูู ุชููุงุฆู |
+| 4๏ธโฃ | **setup-openwebui.sh** | 17KB | ุฅุนุฏุงุฏ OpenWebUI |
+| 5๏ธโฃ | **quick-deploy-openwebui.sh** | 16KB | ูุดุฑ ุณุฑูุน ูู OpenWebUI |
+
+### ๐ ุงูุฃุฏูุฉ ุงูู
ูู
ุฉ | Important Guides
+
+| # | ุงูุฏููู | ุงูุญุฌู
| ุงููุตู |
+|---|-------|------|-------|
+| 1๏ธโฃ | **START-HERE.md** | 3.7KB | โญ ุงุจุฏุฃ ู
ู ููุง - ุฃุจุณุท ุฏููู |
+| 2๏ธโฃ | **README.md** | 20KB | ุงูุฏููู ุงููุงู
ู (ูุฐุง ุงูู
ูู) |
+| 3๏ธโฃ | **DEPLOYMENT.md** | 12KB | ุฏููู ุงููุดุฑ ุงูุชูุตููู |
+| 4๏ธโฃ | **GITHUB-DOWNLOAD.txt** | 13KB | ุทุฑู ุงูุชุญู
ูู ู
ู GitHub |
+| 5๏ธโฃ | **QUICK-START.md** | 2.7KB | ุฏููู ุงูุจุฏุก ุงูุณุฑูุน |
+
+### ๐ฆ ุงูุญุฒู
ุงูู
ุชููุฑุฉ | Available Packages
+
+| ุงูุญุฒู
ุฉ | ุงูุญุฌู
| ุงูู
ุญุชูู |
+|-------|------|---------|
+| **mubsat-deployment.tar.gz** | 44KB | โญ ุญุฒู
ุฉ ู
ุถุบูุทุฉ ุจูู ุงูู
ููุงุช ุงูุฃุณุงุณูุฉ |
+
+### ๐ฏ ุงูุชุตูููุงุช | Categories
+
+- **๐ ุณูุฑูุจุชุงุช ุงููุดุฑ**: 23 ุณูุฑูุจุช ูุฌู
ูุน ุฃููุงุน ุงููุดุฑ
+- **๐ ุงูุชุนููู
ุงุช ูุงูุฃุฏูุฉ**: 36 ุฏููู ุดุงู
ู ุจุงูุนุฑุจู ูุงูุฅูุฌููุฒู
+- **โ๏ธ ู
ููุงุช ุงูุชูููู**: 5 ู
ููุงุช ูุถุจุท ุงูุจูุฆุฉ
+- **๐ Python Scripts**: ู
ุนุงูุฌุฉ ุงูุฐูุงุก ุงูุงุตุทูุงุนู ูุงูุชูุงู
ูุงุช
+- **๐ Web Files**: ูุงุฌูุงุช HTML ุชูุงุนููุฉ
+
+### ๐ก ุงูุชูุตูุงุช | Recommendations
+
+| ุงูุญุงูุฉ | ุงูู
ูู ุงูู
ูุตู ุจู | ุงูุณุจุจ |
+|-------|-----------------|--------|
+| **ููุจุฏุก ุงูุณุฑูุน** | START-HERE.md + DEPLOY-NOW.sh | ุงูุฃุจุณุท ูุงูุฃุณุฑุน |
+| **ูููุดุฑ ุงููุงู
ู** | DEPLOY-NOW.sh --auto | ูุดุฑ ุชููุงุฆู ู
ุชูุงู
ู |
+| **ููุชุญู
ูู ุงูุณุฑูุน** | mubsat-deployment.tar.gz | ุญุฒู
ุฉ ุตุบูุฑุฉ ูู
ุถุบูุทุฉ |
+| **ููููู
ุงูุดุงู
ู** | README.md + DEPLOYMENT.md | ุชูุซูู ูุงู
ู |
+
+---
+
## ๐ ุงูุฏุนู
| Support
ููุฃุณุฆูุฉ ูุงูุฏุนู
:
diff --git a/START-HERE.md b/START-HERE.md
new file mode 100644
index 0000000..10709cb
--- /dev/null
+++ b/START-HERE.md
@@ -0,0 +1,151 @@
+# ุงุจุฏุฃ ู
ู ููุง | START HERE
+
+> **ุงูุฏููู ุงูุฃุจุณุท ููุจุฏุก ุงูุณุฑูุน** | **The Simplest Quick Start Guide**
+
+---
+
+## ๐ ุงูุจุฏุก ุงูุณุฑูุน | Quick Start
+
+### ุงูุทุฑููุฉ ุงูุฃุณุฑุน (ุทุฑููุฉ ูุงุญุฏุฉ ููุท!)
+**The Fastest Way (Just One Step!)**
+
+```bash
+bash DEPLOY-NOW.sh
+```
+
+โ
ูุฐุง ูู ุดูุก! ุงูุจุฑูุงู
ุฌ ุณูููู
ุจูู ุดูุก ุชููุงุฆูุงู
+โ
That's it! The script will do everything automatically
+
+---
+
+## ๐ฅ ุงูุชุญู
ูู | Download
+
+### ุงูุฎูุงุฑ 1: ุชุญู
ูู ุณุฑูุน | Quick Download
+```bash
+# ุงุณุชุฎุฏู
Git Clone
+git clone https://github.com/wasalstor-web/AI-Agent-Platform.git
+cd AI-Agent-Platform
+```
+
+### ุงูุฎูุงุฑ 2: ุญุฒู
ุฉ ูุงู
ูุฉ | Complete Package
+```bash
+# ุญู
ูู ุงูุญุฒู
ุฉ ุงูู
ุถุบูุทุฉ
+wget https://github.com/wasalstor-web/AI-Agent-Platform/raw/main/mubsat-deployment.tar.gz
+tar -xzf mubsat-deployment.tar.gz
+cd AI-Agent-Platform
+```
+
+### ุงูุฎูุงุฑ 3: ู
ู ุงูู
ููุน | From Website
+- ุงุฐูุจ ุฅูู: https://github.com/wasalstor-web/AI-Agent-Platform
+- ุงููุฑ ุนูู "Code" ุซู
"Download ZIP"
+- ูู ุงูุถุบุท ูุงูุชุญ ุงูู
ุฌูุฏ
+
+---
+
+## ๐ฏ ู
ุงุฐุง ุจุนุฏุ | What's Next?
+
+### ูููุดุฑ ุงูููุฑู | For Instant Deployment
+```bash
+bash DEPLOY-NOW.sh
+```
+
+### ูููุตูู ูุฎุงุฏู
API ูุงููุงุฌูุงุช | For API Server & Interfaces Access
+```bash
+bash DEPLOY-NOW.sh --api
+# ุฃู | or
+bash connect-api-server.sh
+```
+
+### ููุฅุนุฏุงุฏ ุงููุฏูู | For Manual Setup
+```bash
+# 1. ุชุซุจูุช ุงูู
ุชุทูุจุงุช | Install Requirements
+pip install -r requirements.txt
+
+# 2. ุชูููู ุงูุจูุฆุฉ | Configure Environment
+cp .env.example .env
+nano .env # ุฃุถู ู
ูุงุชูุญ API ุงูุฎุงุตุฉ ุจู
+
+# 3. ุชุดุบูู ุงูู
ุดุฑูุน | Run Project
+bash quick-start.sh
+```
+
+---
+
+## ๐ ุงูุฃุฏูุฉ ุงูู
ุชููุฑุฉ | Available Guides
+
+| ุงูู
ูู | ุงููุตู | ู
ุชู ุชุณุชุฎุฏู
ู |
+|------|-------|-------------|
+| ๐ **START-HERE.md** | ุฃูุช ููุง! | ููุจุฏุก ุงูุณุฑูุน |
+| ๐ **README.md** | ุงูุฏููู ุงููุงู
ู | ูููู
ุงูู
ุดุฑูุน |
+| ๐ **DEPLOYMENT.md** | ุฏููู ุงููุดุฑ | ูููุดุฑ ุงูุชูุตููู |
+| ๐ **GITHUB-DOWNLOAD.txt** | ุทุฑู ุงูุชุญู
ูู | ูู
ุดุงูู ุงูุชุญู
ูู |
+
+---
+
+## โ ุงูู
ุดุงูู ุงูุดุงุฆุนุฉ | Common Issues
+
+### Problem: `bash: DEPLOY-NOW.sh: Permission denied`
+**ุงูุญู | Solution:**
+```bash
+chmod +x DEPLOY-NOW.sh
+bash DEPLOY-NOW.sh
+```
+
+### Problem: `pip: command not found`
+**ุงูุญู | Solution:**
+```bash
+# ุนูู Ubuntu/Debian
+sudo apt-get update
+sudo apt-get install python3-pip
+
+# ุนูู macOS
+brew install python3
+```
+
+### Problem: `git: command not found`
+**ุงูุญู | Solution:**
+```bash
+# ุนูู Ubuntu/Debian
+sudo apt-get install git
+
+# ุนูู macOS
+brew install git
+```
+
+---
+
+## ๐ก ูุตุงุฆุญ ู
ูู
ุฉ | Important Tips
+
+โ
**ุงุณุชุฎุฏู
DEPLOY-NOW.sh** - ูู ุงูุฃูุถู ูุงูุฃุณูู
+โ
**Use DEPLOY-NOW.sh** - It's the best and easiest
+
+โ
**ูุง ุชูุณู ุฅุถุงูุฉ ู
ูุงุชูุญ API** ูู ู
ูู `.env`
+โ
**Don't forget API keys** in `.env` file
+
+โ
**ุงูุฑุฃ README.md** ูููู
ุงูู
ุดุฑูุน ุจุงููุงู
ู
+โ
**Read README.md** for complete understanding
+
+---
+
+## ๐ ุชุญุชุงุฌ ู
ุณุงุนุฏุฉุ | Need Help?
+
+- ๐ ุงูุฑุฃ ุงูุฏููู ุงููุงู
ู: [README.md](README.md)
+- ๐ ุฏููู ุงููุดุฑ: [DEPLOYMENT.md](DEPLOYMENT.md)
+- ๐ฅ ู
ุดุงูู ุงูุชุญู
ูู: [GITHUB-DOWNLOAD.txt](GITHUB-DOWNLOAD.txt)
+- ๐ ุงูู
ุดุงูู ุงูุชูููุฉ: [GitHub Issues](https://github.com/wasalstor-web/AI-Agent-Platform/issues)
+
+---
+
+## ๐ ู
ุจุฑูู! | Congratulations!
+
+ุงูุขู ุฃูุช ุฌุงูุฒ ููุจุฏุก! ููุท ุดุบูู:
+**Now you're ready to start! Just run:**
+
+```bash
+bash DEPLOY-NOW.sh
+```
+
+---
+
+**ุตููุน ุจู โค๏ธ ููู
ุฌุชู
ุน ุงูุนุฑุจู ูุงูุนุงูู
ู**
+**Made with โค๏ธ for the Arabic and Global Community**
diff --git a/build-package.sh b/build-package.sh
new file mode 100755
index 0000000..dfd7609
--- /dev/null
+++ b/build-package.sh
@@ -0,0 +1,102 @@
+#!/bin/bash
+
+#############################################################################
+# Build Package Script
+# Creates mubsat-deployment.tar.gz with all essential deployment files
+#############################################################################
+
+echo "๐จ Building deployment package..."
+echo ""
+
+# Package name
+PACKAGE_NAME="mubsat-deployment.tar.gz"
+TEMP_DIR="mubsat-deployment-temp"
+
+# Clean up any previous builds
+rm -rf "$TEMP_DIR" "$PACKAGE_NAME"
+
+# Create temporary directory
+mkdir -p "$TEMP_DIR"
+
+echo "๐ฆ Collecting essential files..."
+
+# Define file lists
+DEPLOYMENT_SCRIPTS=(
+ "DEPLOY-NOW.sh"
+ "deploy.sh"
+ "smart-deploy.sh"
+ "quick-start.sh"
+ "autonomous-deploy.sh"
+)
+
+DOCUMENTATION=(
+ "START-HERE.md"
+ "README.md"
+ "DEPLOYMENT.md"
+ "GITHUB-DOWNLOAD.txt"
+ "QUICK-START.md"
+)
+
+CONFIG_FILES=(
+ ".env.example"
+ "requirements.txt"
+ ".gitignore"
+)
+
+# Copy deployment scripts
+echo " โ Deployment scripts"
+for file in "${DEPLOYMENT_SCRIPTS[@]}"; do
+ if ! cp "$file" "$TEMP_DIR/" 2>/dev/null; then
+ echo " Warning: $file not found, skipping..."
+ fi
+done
+
+# Copy documentation
+echo " โ Documentation"
+for file in "${DOCUMENTATION[@]}"; do
+ if ! cp "$file" "$TEMP_DIR/" 2>/dev/null; then
+ echo " Warning: $file not found, skipping..."
+ fi
+done
+
+# Copy configuration files
+echo " โ Configuration files"
+for file in "${CONFIG_FILES[@]}"; do
+ if ! cp "$file" "$TEMP_DIR/" 2>/dev/null; then
+ echo " Warning: $file not found, skipping..."
+ fi
+done
+
+# Copy API directory if it exists
+if [ -d "api" ]; then
+ echo " โ API files"
+ cp -r api "$TEMP_DIR/"
+fi
+
+# Copy index.html if it exists
+if [ -f "index.html" ]; then
+ echo " โ Web interface"
+ cp index.html "$TEMP_DIR/"
+fi
+
+# Create the package
+echo ""
+echo "๐ฆ Creating compressed package..."
+tar -czf "$PACKAGE_NAME" -C "$TEMP_DIR" .
+
+# Clean up temp directory
+rm -rf "$TEMP_DIR"
+
+# Get file size
+SIZE=$(du -h "$PACKAGE_NAME" | cut -f1)
+
+echo ""
+echo "โ
Package created successfully!"
+echo ""
+echo "๐ฆ Package: $PACKAGE_NAME"
+echo "๐ Size: $SIZE"
+echo ""
+echo "๐ Contents:"
+tar -tzf "$PACKAGE_NAME" | head -20
+echo ""
+echo "โ
Ready to distribute!"
diff --git a/connect-api-server.sh b/connect-api-server.sh
new file mode 100755
index 0000000..900e7a6
--- /dev/null
+++ b/connect-api-server.sh
@@ -0,0 +1,233 @@
+#!/bin/bash
+
+#############################################################################
+# API Server Connection Script
+# ุณูุฑูุจุช ุงูุงุชุตุงู ุจุฎุงุฏู
API
+#
+# Description: Connects to API server and provides access to interfaces and models
+# ููุตู ุจุฎุงุฏู
API ููููุฑ ุงููุตูู ูููุงุฌูุงุช ูุงููู
ุงุฐุฌ ููุท
+#
+# Usage: bash connect-api-server.sh [server_url]
+#############################################################################
+
+# Note: Not using set -e to allow explicit error handling for commands that may fail gracefully
+
+# Color codes
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# Default API server URL
+API_SERVER="${1:-http://localhost:5000}"
+
+# Validate API server URL for basic security
+validate_url() {
+ local url="$1"
+ # Allow localhost, 127.0.0.1, or any IP for flexibility in deployment scenarios
+ # In production, consider restricting to specific trusted domains
+ if [[ ! "$url" =~ ^https?:// ]]; then
+ print_error "Invalid API server URL. Must start with http:// or https://"
+ exit 1
+ fi
+}
+
+print_header() {
+ echo ""
+ echo -e "${BLUE}โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ${NC}"
+ echo -e "${CYAN} $1${NC}"
+ echo -e "${BLUE}โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ${NC}"
+ echo ""
+}
+
+print_success() {
+ echo -e "${GREEN}โ${NC} $1"
+}
+
+print_error() {
+ echo -e "${RED}โ${NC} $1"
+}
+
+print_info() {
+ echo -e "${BLUE}โน${NC} $1"
+}
+
+# Validate the API server URL
+validate_url "$API_SERVER"
+
+print_header "๐ ุงูุงุชุตุงู ุจุฎุงุฏู
API | Connecting to API Server"
+
+echo -e "${CYAN}API Server:${NC} $API_SERVER"
+echo ""
+
+# Test API connection
+print_info "Testing connection to API server..."
+if curl -s -f "${API_SERVER}/api/health" > /dev/null 2>&1; then
+ print_success "Connected to API server successfully!"
+else
+ print_error "Cannot connect to API server"
+ print_info "Please ensure:"
+ echo " 1. API server is running"
+ echo " 2. URL is correct: $API_SERVER"
+ echo " 3. Firewall allows connections"
+ echo ""
+ print_info "To start API server locally:"
+ echo " cd api && python3 server.py"
+ exit 1
+fi
+
+# Get API status
+print_info "Fetching API status..."
+STATUS_RESPONSE=$(curl -s "${API_SERVER}/api/status")
+echo "$STATUS_RESPONSE" | python3 -m json.tool 2>/dev/null || echo "$STATUS_RESPONSE"
+echo ""
+
+# Get available models
+print_header "๐ ุงููู
ุงุฐุฌ ุงูู
ุชููุฑุฉ | Available Models"
+MODELS_RESPONSE=$(curl -s "${API_SERVER}/api/models")
+echo "$MODELS_RESPONSE" | python3 -m json.tool 2>/dev/null || echo "$MODELS_RESPONSE"
+echo ""
+
+# Interactive menu
+print_header "๐ฏ ูุงุฆู
ุฉ ุงููุงุฌูุงุช | Interface Menu"
+
+echo -e "${CYAN}Select an option | ุงุฎุชุฑ ุฎูุงุฑุงู:${NC}"
+echo ""
+echo " 1) ${GREEN}ุงููุตูู ูููุงุฌูุงุช${NC} | Access Web Interfaces"
+echo " ูุชุญ ุงููุงุฌูุงุช ุงูุชูุงุนููุฉ"
+echo ""
+echo " 2) ${BLUE}ุนุฑุถ ุงููู
ุงุฐุฌ${NC} | View Models"
+echo " ุนุฑุถ ุฌู
ูุน ุงููู
ุงุฐุฌ ุงูู
ุชุงุญุฉ"
+echo ""
+echo " 3) ${YELLOW}ุงุฎุชุจุงุฑ API${NC} | Test API"
+echo " ุฅุฑุณุงู ุทูุจ ุชุฌุฑูุจู"
+echo ""
+echo " 4) ${CYAN}ุชุดุบูู ุฎุงุฏู
API${NC} | Start API Server"
+echo " ุชุดุบูู ุฎุงุฏู
API ู
ุญููุงู"
+echo ""
+echo " 5) ${RED}ุฎุฑูุฌ${NC} | Exit"
+echo ""
+
+read -p "$(echo -e ${CYAN}Enter choice [1-5]:${NC} )" choice
+
+case $choice in
+ 1)
+ print_info "Opening web interfaces..."
+ echo ""
+ print_success "Available interfaces:"
+ echo ""
+ echo " ๐ Main Interface:"
+ echo " file://$(pwd)/index.html"
+ echo ""
+ echo " ๐ OpenWebUI Demo:"
+ echo " file://$(pwd)/openwebui-demo.html"
+ echo ""
+ echo " ๐๏ธ Dashboard Template:"
+ echo " file://$(pwd)/openwebui-dashboard-template.html"
+ echo ""
+
+ # Try to open in browser
+ if command -v xdg-open &> /dev/null; then
+ xdg-open "index.html" 2>/dev/null &
+ print_success "Opening main interface in browser..."
+ elif command -v open &> /dev/null; then
+ open "index.html" 2>/dev/null &
+ print_success "Opening main interface in browser..."
+ else
+ print_info "Please open the HTML files manually in your browser"
+ fi
+ ;;
+
+ 2)
+ print_info "Fetching detailed models information..."
+ echo ""
+
+ MODELS=$(curl -s "${API_SERVER}/api/models" | python3 -c "
+import sys, json
+try:
+ data = json.load(sys.stdin)
+ models = data.get('models', [])
+
+ print('โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ')
+ print('โ Available AI Models โ')
+ print('โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ')
+ print()
+
+ for i, model in enumerate(models, 1):
+ print(f'{i}. {model[\"name\"]}')
+ print(f' ID: {model[\"id\"]}')
+ print(f' Provider: {model[\"provider\"]}')
+ print(f' Type: {model[\"type\"]}')
+ print()
+except Exception as e:
+ print(f'Error parsing models: {e}')
+" 2>/dev/null)
+
+ echo "$MODELS"
+ ;;
+
+ 3)
+ print_info "Testing API with sample request..."
+ echo ""
+
+ # Test in Arabic
+ print_info "Testing Arabic request..."
+ curl -s -X POST "${API_SERVER}/api/process" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "command": "ู
ุฑุญุจุงู",
+ "context": {
+ "model": "qwen-arabic",
+ "language": "ar"
+ }
+ }' | python3 -m json.tool 2>/dev/null
+
+ echo ""
+
+ # Test in English
+ print_info "Testing English request..."
+ curl -s -X POST "${API_SERVER}/api/process" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "command": "Hello",
+ "context": {
+ "model": "gpt-3.5-turbo",
+ "language": "en"
+ }
+ }' | python3 -m json.tool 2>/dev/null
+
+ echo ""
+ print_success "API test completed!"
+ ;;
+
+ 4)
+ print_info "Starting API server..."
+ echo ""
+
+ if [ -f "api/server.py" ]; then
+ print_success "Found API server file"
+ print_info "Starting server at http://0.0.0.0:5000"
+ echo ""
+ print_info "Press Ctrl+C to stop"
+ echo ""
+ cd api && python3 server.py
+ else
+ print_error "API server file not found!"
+ print_info "Please ensure you are in the project root directory"
+ fi
+ ;;
+
+ 5)
+ print_info "Exiting..."
+ exit 0
+ ;;
+
+ *)
+ print_error "Invalid choice!"
+ ;;
+esac
+
+echo ""
+print_success "Done!"
diff --git a/mubsat-deployment.tar.gz b/mubsat-deployment.tar.gz
new file mode 100644
index 0000000..32c53df
Binary files /dev/null and b/mubsat-deployment.tar.gz differ