vllm-omni/scripts/README.md

vLLM-omni Testing Scripts

This directory contains automated testing scripts for vLLM-omni serving functionality.

Scripts Overview

1. test_serving.sh - Comprehensive Test Suite

Full-featured testing script that performs complete validation of the vLLM-omni serving functionality.

Features:

• Model existence validation
• Environment setup verification
• Import functionality testing
• Server startup and health checks
• Text generation testing
• Performance benchmarking
• API client integration testing
• Comprehensive logging and error handling

Usage:

# Use default model and port
./scripts/test_serving.sh

# Use specific model and port
./scripts/test_serving.sh ./models/Qwen3-0.6B 8000

# Use HuggingFace model
./scripts/test_serving.sh Qwen/Qwen3-0.6B 8001

# Show help
./scripts/test_serving.sh --help

Test Coverage:

• ✅ Model loading and server startup
• ✅ Health and info endpoints
• ✅ Text generation functionality
• ✅ Performance metrics
• ✅ API client integration
• ✅ All imports working correctly

2. quick_test.sh - Fast Validation

Lightweight script for quick validation after making changes.

Features:

• Fast import testing
• Basic server startup
• Health endpoint validation
• Simple text generation test
• Retry mechanism for reliability

Usage:

# Use default port (8000)
./scripts/quick_test.sh

# Use specific port
./scripts/quick_test.sh 8001

Test Coverage:

• ✅ Import functionality
• ✅ Server startup
• ✅ Health endpoint
• ✅ Basic text generation

Prerequisites

1. Conda Environment: Ensure vllm_omni environment is activated
2. Model Available: Qwen3-0.6B model should be available in ./models/Qwen3-0.6B/
3. Dependencies: All vLLM-omni dependencies should be installed

Environment Setup

# Activate conda environment
conda activate vllm_omni

# Verify installation
python -c "import vllm_omni; print('vLLM-omni ready')"

Model Setup

The scripts expect the Qwen3-0.6B model to be available. You can:

1. Use local model: Place model in ./models/Qwen3-0.6B/
2. Use HuggingFace model: Pass Qwen/Qwen3-0.6B as model path
3. Download model: Use the download_models.py script

# Download model using the provided script
python scripts/download_models.py

Output and Logging

Test Results

• Success: Green [SUCCESS] messages
• Info: Blue [INFO] messages
• Warnings: Yellow [WARNING] messages
• Errors: Red [ERROR] messages

Log Files

• server.log: Server startup and runtime logs
• api_client_test.log: API client test results
• simple_usage_test.log: Simple usage test results