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 @@ [![Python](https://img.shields.io/badge/Python-3.9+-3776AB?logo=python&logoColor=white)](https://www.python.org/) [![FastAPI](https://img.shields.io/badge/FastAPI-009688?logo=fastapi&logoColor=white)](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