Requirements

System and software requirements for AutoDoctor installation and operation, including installer mode, system-Python mode, development .venv mode, and optional PDF export support.
Categories:
Tags:

Who This Is For

  • DIY users preparing first installation.
  • Technical users preparing repeatable installation.

Minimum Platform Requirements

  • Windows 10 or Windows 11 (x64)
  • Local administrator permissions for install, service registration, and diagnostics/remediation
  • PowerShell 5.1+
  • Network access for optional connectivity checks, update checks, and package installation

Runtime Requirements by Installation Mode

Bundled Service Runtime (Default)

  • No preinstalled Python required for service startup
  • Installer deploys compiled service wrapper and compiled API binary

System Python Service Runtime (Advanced)

  • Python 3.12.x installed and accessible via py -3 or python
  • Required packages in that interpreter:
python -m pip install pywin32 fastapi uvicorn

Optional Report Export Requirement

AutoDoctor always creates HTML, JSON, and Markdown reports. PDF generation is optional and depends on a Chromium-based browser being available.

  • Google Chrome or Chromium installed locally
  • Optional override with AUTO_DOCTOR_CHROMIUM_PATH if Chrome is not in a standard path

If Chrome is missing, the scan still completes. Only automatic PDF export is skipped.

Build-Time Requirements (for Developers)

If you build the installer and binaries yourself:

  • Python 3.12
  • Project .venv recommended at server/api/.venv
  • PyInstaller
  • Inno Setup 6 (ISCC.exe)
py -3.12 -m pip install --upgrade pip
py -3.12 -m pip install pyinstaller fastapi uvicorn pywin32

Verify Environment Before Install 

# PowerShell check
$PSVersionTable.PSVersion

# Admin check
([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltinRole]::Administrator)

# Optional Python checks for system-Python service mode
py -3 --version
python --version
python -c "import win32serviceutil,servicemanager,fastapi,uvicorn; print('ok')"

# Optional PDF export check
Get-Command chrome.exe -ErrorAction SilentlyContinue

Expected outcome:

  • Admin check returns True
  • Python checks succeed only if you plan to use system-Python service mode
  • Chrome check resolves only if you want automatic PDF output during scans

Next Steps