Skip to main content

Windows Local Installation Wizard

Note: This guide is specifically designed for Intel AI machines running Windows OS.

Overview​

The Artemis Windows Local Installation Wizard (ArtemisWizard.exe) automates the installation and configuration of Artemis on Windows systems with Intel AI hardware. The wizard performs system verification, handles Docker image management, configures OpenVINO, and sets up the Artemis platform.

Prerequisites​

System Requirements​

  • Operating System: Windows 10 or Windows 11
  • WSL 2: Windows Subsystem for Linux 2 enabled and configured
  • Docker Desktop: Latest version installed and running
  • WSL Distribution: Ubuntu Linux (latest version, see Issue #5 for installation instructions)
  • Administrator Access: Required for installation

Software Dependencies​

  • Docker Desktop with Docker Compose
  • Docker Hub account with registry access
  • Intel GPU drivers (for OpenVINO)

Installation Package​

Download: ArtemisWizard.exe

Note: Credentials are required to access the download. Contact TurinTech for access credentials.

Installation: Execute ArtemisWizard.exe to launch the installation wizard.

Installation Procedure​

Follow the installation steps below to complete the Artemis installation.

Step 1: System Verification​

The wizard performs automated system verification to ensure the environment meets installation requirements.

Verification Checks:

  1. Container Environment:

    • Docker Desktop service status
    • Docker Compose availability

  2. System Resources:

    • CPU core availability
    • Memory capacity
    • Storage space

Default Configuration:

  • Docker Compose is included with Docker Desktop
  • Docker Desktop allocates 8 CPU cores by default
  • Adjust resource allocation in Docker Desktop settings if additional cores are available

Procedure:

  1. Review verification results
  2. Click Next to proceed
note

WSL 2 Configuration: Ensure WSL 2 is installed and enabled in Docker Desktop. Docker Desktop will prompt for WSL 2 installation if not detected.

Step 2: Authentication​

The wizard authenticates with the Docker registry using preconfigured credentials.

Prerequisites:

  • Docker Hub account with registry access
  • WSL 2 installed and configured (required for Docker on Windows)

Procedure:

  1. Verify Docker Hub registry access
  2. Click Next to initiate Docker authentication
note

Expected Behavior: Docker Desktop may launch automatically and display a login window. Complete the authentication process before proceeding.

Step 3: Requirements​

The wizard downloads all required Docker images for Artemis deployment.

Procedure:

  1. Click Pull Images & Continue to download or update Docker images
  2. Wait for image download to complete. All successfully downloaded images are marked with a checkmark
  3. Click Next to proceed

Step 4: Configuration​

Configure Artemis service ports and OpenVINO deployment method.

Port Configuration:

ServiceDefault PortDescription
HTTP81HTTP service port
HTTPS443HTTPS service port

Note: Modify ports if conflicts exist with other applications.

OpenVINO Deployment Method:

Option A: Container Runtime (Docker) — Recommended

  • Requirements:
    • Ubuntu WSL2 Linux distribution 24.04 or later (see Issue #5)
    • Latest Intel GPU drivers
  • Procedure: Click Next to proceed with containerized deployment

Option B: Native Deployment

  • Requirements:
    • Python 3.9–3.12
    • Git installed
    • Latest Intel GPU drivers
  • Procedure:
    1. Click Run Setup for immediate installation, or
    2. Click Create Shortcut to create a desktop shortcut for later installation
    3. Monitor installation logs for completion status

Procedure:

  1. Configure ports and OpenVINO deployment method
  2. Click Save & Continue

Step 5: OpenVINO Verification​

The wizard verifies OpenVINO deployment prerequisites.

Verification Checks:

ComponentDescription
Intel GPU DriverValidates latest Intel GPU driver installation
WSL VersionVerifies WSL 2 configuration
Linux DistributionChecks Ubuntu distribution compatibility
GPU PassthroughValidates GPU passthrough configuration

Procedure:

  1. Review verification results
  2. Resolve any failed checks before proceeding
  3. Click Next to continue
note

OpenVINO Connection Endpoints: Reference these endpoints when configuring OpenVINO:

  • http://host.docker.internal:8000/v3
  • http://ovms:8000/v3

Step 6: Installation​

The wizard deploys Artemis services and creates the default administrator account.

Deployment Procedure:

  1. Click Start Deployment to initiate installation
  2. Wait for all services to deploy (process is automated)

Administrator Account Setup:

  1. Enter administrator credentials:
    • Username
    • Password
  2. Click Create Admin User
  3. Click Next to continue

Step 7: Completion​

Installation is complete.

OpenVINO Model Verification: The wizard performs a test query against the OpenVINO model deployment to verify functionality.

Post-Installation:

  1. Desktop Shortcuts: The following shortcuts are created automatically:

    • Artemis Platform: Launch Artemis web interface (ArtemisWizard.exe icon)
    • OpenVINO: Launch OpenVINO (created if native deployment was selected in Step 4)

  2. Access Artemis Platform:

    • Click Open Artemis to launch the web interface in your default browser
    • Authenticate using the administrator credentials created in Step 6

ArtemisWizard.exe Desktop Shortcuts

Post-Installation Configuration​

Initial Platform Setup​

Complete the following one-time configuration after first login:

  1. Navigate to Settings (⚙️ icon, top-right)
  2. Select Users from the sidebar
  3. Locate the System Admin Balance column
  4. Click Edit
  5. Enter an initial balance (e.g., 50)
  6. Click Apply

Note: This configuration is required to unlock full platform functionality.

OpenVINO Connection Verification​

Verify OpenVINO model connectivity:

  1. Ensure Artemis services are running
  2. Log into the Artemis platform
  3. Navigate to Chat (top-right)
  4. Submit a test query
  5. Verify model response to confirm successful connection

Troubleshooting​

System Requirements​

General Requirements:

  • Docker Desktop requires WSL 2 on Windows
  • Artemis supports multiple platform configurations

OpenVINO Requirements:

  • Ubuntu 20.04 or higher (required for GPU passthrough via DXG)
  • Python 3.9–3.12
  • More restrictive platform requirements than Artemis core

Common Issues​

Issue 1: Python Version Compatibility​

Symptoms: OpenVINO setup fails with incompatible Python version error.

Resolution:

  1. Download Python 3.12.10 (64-bit): Python 3.12.10
  2. Install Python and verify version (3.9–3.12)
  3. Ensure Python is added to system PATH during installation
  4. Restart the installation wizard

Issue 2: Docker Service Not Running​

Symptoms: Installation fails with Docker-related errors.

Resolution:

  1. Verify Docker Desktop service status
  2. If issues persist, perform a full restart:
    • Open Task Manager (Ctrl + Shift + Esc)
    • Terminate all Docker-related processes
    • Restart Docker Desktop

Issue 3: VPN Connectivity Issues​

Symptoms: Docker or OpenVINO connectivity failures during installation.

Resolution:

  1. Disconnect from VPN temporarily
  2. Complete installation
  3. Reconnect to VPN after installation
  4. Configure VPN exceptions for Docker if required

Issue 4: Missing GPU Drivers​

Symptoms: OpenVINO operates in CPU-only mode or fails to detect GPU.

Resolution:

  1. In the wizard, click Intel GPU (Required)
  2. Download the latest Intel GPU driver from the opened page
  3. Install the driver
  4. Return to the wizard and verify GPU detection

Issue 5: Ubuntu Version Incompatibility​

Symptoms: OpenVINO fails due to unsupported Ubuntu version.

Resolution:

Upgrade WSL 2 Ubuntu distribution to 20.04 or later:

wsl --status
wsl --list --online 
wsl --install -d Ubuntu-24.04 
wsl --set-default Ubuntu-24.04

Note: OpenVINO requires Ubuntu 20.04 or higher for GPU passthrough. Ensure GPU drivers are installed after upgrading.

Reference​

System Requirements Summary​

ComponentRequirement
Operating SystemWindows 10/11 with WSL 2
Docker DesktopLatest version, running
WSL DistributionUbuntu 20.04 or later
Access LevelAdministrator privileges

Registry Access​

  • Docker Hub account with registry access required
  • WSL 2 must be installed (required for Docker on Windows)
  • If WSL 2 was not installed during Docker Desktop setup, install manually before proceeding

OpenVINO Endpoints​

When configuring OpenVINO, reference these connection endpoints:

  • http://host.docker.internal:8000/v3
  • http://ovms:8000/v3
Last updated on by manal