feat: Add comprehensive configuration management and startup automation

- Add .env file with correct default configurations
- Create automated startup scripts (start-server.sh, start-server.bat)
- Add Ollama connectivity validation on server startup
- Update README with improved setup instructions and troubleshooting
- Prevent common configuration issues (wrong host, model mismatch, port conflicts)
- Add cross-platform support for macOS/Linux and Windows

Fixes issues with:
- Ollama host resolution (ollama:11434 -> 127.0.0.1:11434)
- Model availability (llama3.1:8b -> llama3.2:latest)
- Port conflicts and startup automation

README.md

@@ -50,9 +50,42 @@ A FastAPI-based backend service for text summarization using Ollama's local lang
    pip install -r requirements.txt
    ```
 
-4. **Run the API**
+4. **Start the server (Recommended)**
    ```bash
-   uvicorn app.main:app --host 127.0.0.1 --port 8000 --reload
+   # Use the automated startup script (checks everything for you)
+   ./start-server.sh
+   ```
+   
+   **OR manually:**
+   ```bash
+   # Start the server manually
+   uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
+   ```
+
+## Configuration
+
+The server uses environment variables for configuration. A `.env` file is automatically created with sensible defaults:
+
+```bash
+# Ollama Configuration
+OLLAMA_HOST=http://127.0.0.1:11434
+OLLAMA_MODEL=llama3.2:latest
+OLLAMA_TIMEOUT=30
+
+# Server Configuration  
+SERVER_HOST=0.0.0.0
+SERVER_PORT=8000
+LOG_LEVEL=INFO
+```
+
+**Common Issues & Solutions:**
+
+- **Port already in use**: The startup script automatically handles this
+- **Ollama connection failed**: Ensure Ollama is running (`ollama serve`)
+- **Model not found**: Install the model (`ollama pull llama3.2:latest`)
+- **Wrong host configuration**: The `.env` file ensures correct localhost settings
+
+## API Usage
    ```
 
 5. **Test the API**

app/main.py

@@ -9,6 +9,7 @@ from app.core.logging import setup_logging, get_logger
 from app.api.v1.routes import api_router
 from app.core.middleware import request_context_middleware
 from app.core.errors import init_exception_handlers
+from app.services.summarizer import ollama_service
 
 # Set up logging
 setup_logging()
@@ -48,6 +49,20 @@ async def startup_event():
     logger.info("Starting Text Summarizer API")
     logger.info(f"Ollama host: {settings.ollama_host}")
     logger.info(f"Ollama model: {settings.ollama_model}")
+    
+    # Validate Ollama connectivity
+    try:
+        is_healthy = await ollama_service.check_health()
+        if is_healthy:
+            logger.info("✅ Ollama service is accessible and healthy")
+        else:
+            logger.warning("⚠️  Ollama service is not responding properly")
+            logger.warning(f"   Please ensure Ollama is running at {settings.ollama_host}")
+            logger.warning(f"   And that model '{settings.ollama_model}' is available")
+    except Exception as e:
+        logger.error(f"❌ Failed to connect to Ollama: {e}")
+        logger.error(f"   Please check that Ollama is running at {settings.ollama_host}")
+        logger.error(f"   And that model '{settings.ollama_model}' is installed")
 
 
 @app.on_event("shutdown")

start-server.bat

@@ -0,0 +1,54 @@
+@echo off
+REM Text Summarizer API Startup Script for Windows
+REM This script ensures the server starts with the correct configuration
+
+echo 🚀 Starting Text Summarizer API Server...
+
+REM Check if .env file exists, if not create it with defaults
+if not exist .env (
+    echo 📝 Creating .env file with default configuration...
+    (
+        echo # Text Summarizer API Configuration
+        echo OLLAMA_HOST=http://127.0.0.1:11434
+        echo OLLAMA_MODEL=llama3.2:latest
+        echo OLLAMA_TIMEOUT=30
+        echo SERVER_HOST=0.0.0.0
+        echo SERVER_PORT=8000
+        echo LOG_LEVEL=INFO
+        echo API_KEY_ENABLED=false
+        echo RATE_LIMIT_ENABLED=false
+        echo RATE_LIMIT_REQUESTS=60
+        echo RATE_LIMIT_WINDOW=60
+        echo MAX_TEXT_LENGTH=32000
+        echo MAX_TOKENS_DEFAULT=256
+    ) > .env
+    echo ✅ .env file created with default values
+)
+
+REM Check if Ollama is running
+echo 🔍 Checking Ollama service...
+curl -s http://127.0.0.1:11434/api/tags >nul 2>&1
+if %errorlevel% equ 0 (
+    echo ✅ Ollama is running and accessible
+) else (
+    echo ❌ Ollama is not running or not accessible at http://127.0.0.1:11434
+    echo    Please start Ollama first:
+    echo    - Download and install Ollama from https://ollama.ai
+    echo    - Start the Ollama application
+    pause
+    exit /b 1
+)
+
+REM Start the server
+echo 🌟 Starting FastAPI server...
+echo    Server will be available at: http://localhost:8000
+echo    API docs will be available at: http://localhost:8000/docs
+echo    Press Ctrl+C to stop the server
+echo.
+
+REM Load environment variables and start uvicorn
+for /f "usebackq tokens=1,2 delims==" %%a in (.env) do (
+    if not "%%a"=="" if not "%%a:~0,1%"=="#" set %%a=%%b
+)
+
+uvicorn app.main:app --host %SERVER_HOST% --port %SERVER_PORT% --reload

start-server.sh

@@ -0,0 +1,71 @@
+#!/bin/bash
+
+# Text Summarizer API Startup Script
+# This script ensures the server starts with the correct configuration
+
+set -e  # Exit on any error
+
+echo "🚀 Starting Text Summarizer API Server..."
+
+# Check if .env file exists, if not create it with defaults
+if [ ! -f .env ]; then
+    echo "📝 Creating .env file with default configuration..."
+    cat > .env << 'EOF'
+# Text Summarizer API Configuration
+OLLAMA_HOST=http://127.0.0.1:11434
+OLLAMA_MODEL=llama3.2:latest
+OLLAMA_TIMEOUT=30
+SERVER_HOST=0.0.0.0
+SERVER_PORT=8000
+LOG_LEVEL=INFO
+API_KEY_ENABLED=false
+RATE_LIMIT_ENABLED=false
+RATE_LIMIT_REQUESTS=60
+RATE_LIMIT_WINDOW=60
+MAX_TEXT_LENGTH=32000
+MAX_TOKENS_DEFAULT=256
+EOF
+    echo "✅ .env file created with default values"
+fi
+
+# Check if Ollama is running
+echo "🔍 Checking Ollama service..."
+if curl -s http://127.0.0.1:11434/api/tags > /dev/null 2>&1; then
+    echo "✅ Ollama is running and accessible"
+    
+    # Check if the configured model is available
+    MODEL=$(grep OLLAMA_MODEL .env | cut -d'=' -f2)
+    if curl -s http://127.0.0.1:11434/api/tags | grep -q "\"$MODEL\""; then
+        echo "✅ Model '$MODEL' is available"
+    else
+        echo "⚠️  Warning: Model '$MODEL' not found in Ollama"
+        echo "   Available models:"
+        curl -s http://127.0.0.1:11434/api/tags | grep -o '"name":"[^"]*"' | sed 's/"name":"//g' | sed 's/"//g' | sed 's/^/   - /'
+    fi
+else
+    echo "❌ Ollama is not running or not accessible at http://127.0.0.1:11434"
+    echo "   Please start Ollama first:"
+    echo "   - On macOS: Open Ollama app or run 'ollama serve'"
+    echo "   - On Linux: run 'ollama serve'"
+    echo "   - On Windows: Open Ollama app"
+    exit 1
+fi
+
+# Kill any existing server on the configured port
+PORT=$(grep SERVER_PORT .env | cut -d'=' -f2)
+if lsof -i :$PORT > /dev/null 2>&1; then
+    echo "🔄 Stopping existing server on port $PORT..."
+    pkill -f "uvicorn.*$PORT" || true
+    sleep 2
+fi
+
+# Start the server
+echo "🌟 Starting FastAPI server..."
+echo "   Server will be available at: http://localhost:$PORT"
+echo "   API docs will be available at: http://localhost:$PORT/docs"
+echo "   Press Ctrl+C to stop the server"
+echo ""
+
+# Load environment variables and start uvicorn
+export $(cat .env | grep -v '^#' | xargs)
+uvicorn app.main:app --host $SERVER_HOST --port $SERVER_PORT --reload