#!/usr/bin/env python3 """ ALwrity Backend Server - Modular Startup Script Handles setup, dependency installation, and server startup using modular utilities. Run this from the backend directory to set up and start the FastAPI server. """ import os import sys import argparse from pathlib import Path def bootstrap_linguistic_models(): """ Bootstrap spaCy and NLTK models BEFORE any imports. This prevents import-time failures when EnhancedLinguisticAnalyzer is loaded. """ import subprocess import os verbose = os.getenv("ALWRITY_VERBOSE", "false").lower() == "true" if verbose: print("šŸ” Bootstrapping linguistic models...") # Check and download spaCy model try: import spacy try: nlp = spacy.load("en_core_web_sm") if verbose: print(" āœ… spaCy model 'en_core_web_sm' available") except OSError: if verbose: print(" āš ļø spaCy model 'en_core_web_sm' not found, downloading...") try: subprocess.check_call([ sys.executable, "-m", "spacy", "download", "en_core_web_sm" ]) if verbose: print(" āœ… spaCy model downloaded successfully") except subprocess.CalledProcessError as e: if verbose: print(f" āŒ Failed to download spaCy model: {e}") print(" Please run: python -m spacy download en_core_web_sm") return False except ImportError: if verbose: print(" āš ļø spaCy not installed - skipping") # Check and download NLTK data try: import nltk essential_data = [ ('punkt_tab', 'tokenizers/punkt_tab'), ('stopwords', 'corpora/stopwords'), ('averaged_perceptron_tagger', 'taggers/averaged_perceptron_tagger') ] for data_package, path in essential_data: try: nltk.data.find(path) if verbose: print(f" āœ… NLTK {data_package} available") except LookupError: if verbose: print(f" āš ļø NLTK {data_package} not found, downloading...") try: nltk.download(data_package, quiet=True) if verbose: print(f" āœ… NLTK {data_package} downloaded") except Exception as e: if verbose: print(f" āš ļø Failed to download {data_package}: {e}") # Try fallback if data_package == 'punkt_tab': try: nltk.download('punkt', quiet=True) if verbose: print(f" āœ… NLTK punkt (fallback) downloaded") except: pass except ImportError: if verbose: print(" āš ļø NLTK not installed - skipping") if verbose: print("āœ… Linguistic model bootstrap complete") return True # Bootstrap linguistic models BEFORE any imports that might need them if __name__ == "__main__": bootstrap_linguistic_models() # NOW import modular utilities (after bootstrap) from alwrity_utils import ( DependencyManager, EnvironmentSetup, DatabaseSetup, ProductionOptimizer ) def start_backend(enable_reload=False, production_mode=False): """Start the backend server.""" print("šŸš€ Starting ALwrity Backend...") # Set host based on environment and mode # Use 127.0.0.1 for local production testing on Windows # Use 0.0.0.0 for actual cloud deployments (Render, Railway, etc.) default_host = os.getenv("RENDER") or os.getenv("RAILWAY_ENVIRONMENT") or os.getenv("DEPLOY_ENV") if default_host: # Cloud deployment detected - use 0.0.0.0 os.environ.setdefault("HOST", "0.0.0.0") else: # Local deployment - use 127.0.0.1 for better Windows compatibility os.environ.setdefault("HOST", "127.0.0.1") os.environ.setdefault("PORT", "8000") # Set reload based on argument or environment variable if enable_reload and not production_mode: os.environ.setdefault("RELOAD", "true") print(" šŸ”„ Development mode: Auto-reload enabled") else: os.environ.setdefault("RELOAD", "false") print(" šŸ­ Production mode: Auto-reload disabled") host = os.getenv("HOST") port = int(os.getenv("PORT", "8000")) reload = os.getenv("RELOAD", "false").lower() == "true" print(f" šŸ“ Host: {host}") print(f" šŸ”Œ Port: {port}") print(f" šŸ”„ Reload: {reload}") try: # Import and run the app from app import app from services.database import init_database import uvicorn # Explicitly initialize database before starting server init_database() print("\n🌐 ALwrity Backend Server") print("=" * 50) print(" šŸ“– API Documentation: http://localhost:8000/api/docs") print(" šŸ” Health Check: http://localhost:8000/health") print(" šŸ“Š ReDoc: http://localhost:8000/api/redoc") if not production_mode: print(" šŸ“ˆ API Monitoring: http://localhost:8000/api/content-planning/monitoring/health") print(" šŸ’³ Billing Dashboard: http://localhost:8000/api/subscription/plans") print(" šŸ“Š Usage Tracking: http://localhost:8000/api/subscription/usage/demo") print("\n[STOP] Press Ctrl+C to stop the server") print("=" * 50) # Set up clean logging for end users from logging_config import setup_clean_logging, get_uvicorn_log_level # Video stack preflight (diagnostics + version assert) try: from services.story_writer.video_preflight import ( log_video_stack_diagnostics, assert_supported_moviepy, ) except Exception: # Preflight is optional; continue if module missing log_video_stack_diagnostics = None assert_supported_moviepy = None verbose_mode = setup_clean_logging() uvicorn_log_level = get_uvicorn_log_level() # Log diagnostics and assert versions (fail fast if misconfigured) try: if log_video_stack_diagnostics: log_video_stack_diagnostics() if assert_supported_moviepy: assert_supported_moviepy() except Exception as _video_stack_err: print(f"[ERROR] Video stack preflight failed: {_video_stack_err}") return False uvicorn.run( "app:app", host=host, port=port, reload=reload, reload_excludes=[ "*.pyc", "*.pyo", "*.pyd", "__pycache__", "*.log", "*.sqlite", "*.db", "*.tmp", "*.temp", "test_*.py", "temp_*.py", "monitoring_data_service.py", "test_monitoring_save.py", "*.json", "*.yaml", "*.yml", ".env*", "logs/*", "cache/*", "tmp/*", "temp/*", "middleware/*", "models/*", "scripts/*", "alwrity_utils/*" ], reload_includes=[ "app.py", "api/**/*.py", "services/**/*.py" ], log_level=uvicorn_log_level ) except KeyboardInterrupt: print("\n\nšŸ›‘ Backend stopped by user") except Exception as e: print(f"\n[ERROR] Error starting backend: {e}") return False return True def main(): """Main function to set up and start the backend.""" # Parse command line arguments parser = argparse.ArgumentParser(description="ALwrity Backend Server") parser.add_argument("--reload", action="store_true", help="Enable auto-reload for development") parser.add_argument("--dev", action="store_true", help="Enable development mode (auto-reload)") parser.add_argument("--production", action="store_true", help="Enable production mode (optimized for deployment)") parser.add_argument("--verbose", action="store_true", help="Enable verbose logging for debugging") args = parser.parse_args() # Determine mode production_mode = args.production enable_reload = (args.reload or args.dev) and not production_mode verbose_mode = args.verbose # Set global verbose flag for utilities os.environ["ALWRITY_VERBOSE"] = "true" if verbose_mode else "false" print("šŸš€ ALwrity Backend Server") print("=" * 40) print(f"Mode: {'PRODUCTION' if production_mode else 'DEVELOPMENT'}") print(f"Auto-reload: {'ENABLED' if enable_reload else 'DISABLED'}") if verbose_mode: print("Verbose logging: ENABLED") print("=" * 40) # Check if we're in the right directory if not os.path.exists("app.py"): print("[ERROR] Error: app.py not found. Please run this script from the backend directory.") print(" Current directory:", os.getcwd()) print(" Expected files:", [f for f in os.listdir('.') if f.endswith('.py')]) return False # Initialize modular components dependency_manager = DependencyManager() environment_setup = EnvironmentSetup(production_mode=production_mode) database_setup = DatabaseSetup(production_mode=production_mode) production_optimizer = ProductionOptimizer() # Setup progress tracking setup_steps = [ "Checking dependencies", "Setting up environment", "Configuring database", "Starting server" ] print("šŸ”§ Initializing ALwrity...") # Apply production optimizations if needed if production_mode: if not production_optimizer.apply_production_optimizations(): print("āŒ Production optimization failed") return False # Step 1: Dependencies print(f" šŸ“¦ {setup_steps[0]}...", end=" ", flush=True) critical_ok, missing_critical = dependency_manager.check_critical_dependencies() if not critical_ok: print("installing...", end=" ", flush=True) if not dependency_manager.install_requirements(): print("āŒ Failed") return False print("āœ… Done") else: print("āœ… Done") # Check optional dependencies (non-critical) - only in verbose mode if verbose_mode: dependency_manager.check_optional_dependencies() # Step 2: Environment print(f" šŸ”§ {setup_steps[1]}...", end=" ", flush=True) if not environment_setup.setup_directories(): print("āŒ Directory setup failed") return False if not environment_setup.setup_environment_variables(): print("āŒ Environment setup failed") return False # Create .env file only in development if not production_mode: environment_setup.create_env_file() print("āœ… Done") # Step 3: Database print(f" šŸ“Š {setup_steps[2]}...", end=" ", flush=True) if not database_setup.setup_essential_tables(): print("āš ļø Issues detected, continuing...") else: print("āœ… Done") # Setup advanced features in development, verify in all modes if not production_mode: database_setup.setup_advanced_tables() # Always verify database tables (important for both dev and production) database_setup.verify_tables() # Note: Linguistic models (spaCy/NLTK) are bootstrapped before imports # See bootstrap_linguistic_models() at the top of this file # Step 4: Start backend print(f" šŸš€ {setup_steps[3]}...") return start_backend(enable_reload=enable_reload, production_mode=production_mode) if __name__ == "__main__": success = main() if not success: sys.exit(1)