dark_hal/DEPENDENCY_INSTALLER_README.md

Windows Dependency Installer for LLM_Train

This dependency installer helps you automatically install common software packages required for LLM_Train on Windows using the Chocolatey package manager.

Quick Start

Option 1: Batch File (Recommended)

1. Double-click install_dependencies.bat
2. Grant administrator permissions when prompted
3. Select packages to install in the GUI

Option 2: PowerShell Script

1. Right-click install_dependencies.ps1 → "Run with PowerShell"
2. Grant administrator permissions when prompted
3. Select packages to install in the GUI

Option 3: Direct Python Execution

# Run as administrator
python windows_dependency_installer.py

What Gets Installed

Essential Packages (Auto-selected)

• Git - Version control system (required for repository cloning)
• Python 3 - Python programming language (if not already installed)
• 7-Zip - File archiver for extracting downloads
• Visual C++ Redistributables - Microsoft runtime libraries

Development Tools

• Visual Studio Code - Advanced code editor with Python support
• Notepad++ - Enhanced text editor

GPU Acceleration

• CUDA Toolkit - NVIDIA CUDA development toolkit for GPU acceleration
• NVIDIA Display Driver - Latest NVIDIA graphics drivers

System Utilities

• Wget - Command-line downloader
• cURL - Data transfer tool
• PowerToys - Windows system utilities

Runtimes

• .NET Runtime - Microsoft .NET framework

Optional Tools

• WinRAR - Alternative file archiver
• Firefox - Web browser
• VLC Media Player - Media player

System Requirements

• Windows 10/11 (Windows 8.1 may work but is not tested)
• Administrator privileges (required for Chocolatey and package installation)
• Internet connection (for downloading packages)
• Python 3.7+ (for running the installer GUI)

Features

Chocolatey Integration

• Automatically installs Chocolatey if not present
• Uses Chocolatey's robust package management
• Handles dependencies automatically

Smart Package Selection

• Select Essential - Chooses only required packages
• Select All - Selects all available packages
• Custom Selection - Pick individual packages

Installation Monitoring

• Real-time installation log
• Progress tracking
• Success/failure reporting
• Package status checking

System Status Checks

• Administrator privilege detection
• Chocolatey installation status
• Individual package installation status

Troubleshooting

"Python not found" Error

1. Install Python from https://python.org/downloads/
2. During installation, check "Add Python to PATH"
3. Restart your command prompt/PowerShell

"Administrator privileges required" Error

1. Right-click the batch file → "Run as administrator"
2. Or open Command Prompt as administrator and run manually

"Chocolatey installation failed" Error

1. Ensure you're running as administrator
2. Check your internet connection
3. Temporarily disable antivirus software during installation
4. Check Windows execution policy: Set-ExecutionPolicy RemoteSigned

Package Installation Failures

1. Check the installation log for specific error messages
2. Try installing packages individually
3. Ensure sufficient disk space
4. Check for conflicting software

Network/Firewall Issues

1. Ensure Chocolatey URLs are not blocked:
   • https://community.chocolatey.org/
   • https://packages.chocolatey.org/
2. Configure proxy settings if behind corporate firewall
3. Temporarily disable firewall/antivirus

Manual Installation

If the automatic installer fails, you can install Chocolatey manually:

1. Open PowerShell as Administrator
2. Run:

   Set-ExecutionPolicy Bypass -Scope Process -Force;
   [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072;
   iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
   

3. Then install packages manually:

   choco install git python 7zip vcredist-all -y
   choco install cuda nvidia-display-driver -y  # For GPU support
   

Package Descriptions

Why Each Package?

• Git: Required for cloning model repositories and version control
• Python: Core runtime for LLM_Train (if system Python is outdated)
• 7-Zip: Many model files are compressed and need extraction
• Visual C++ Redistributables: Required by many Python packages and binaries
• CUDA Toolkit: Enables GPU acceleration for faster model inference
• NVIDIA Drivers: Latest drivers for optimal GPU performance
• Visual Studio Code: Best IDE for Python development and debugging
• Wget/cURL: Alternative download tools for model files
• PowerToys: Useful Windows utilities for power users

Security Notes

• All packages are installed from official Chocolatey community repository
• Chocolatey packages are maintained by the community and Microsoft
• Administrator privileges are required only for system-wide installation
• No personal data is collected or transmitted

Support

If you encounter issues:

1. Check the installation log for error messages
2. Search for the specific error on Chocolatey community forums
3. Try installing individual packages manually
4. Ensure your Windows is up to date

License

This installer uses Chocolatey (Apache 2.0 License) and installs various packages with their respective licenses. Please review individual package licenses as needed.