From 0cd306e68b39911e4a8a093ad69414123bde293f Mon Sep 17 00:00:00 2001
From: Jacob Howard <jacob.howard@docker.com>
Date: Fri, 13 Jun 2025 16:31:48 -0600
Subject: [PATCH] Detect operating environment and adjust certain behaviors.

This commit introduces a new environment detection mechanism based on
process name and environment variables.

It uses this information (initially) for the purposes of tuning
concurrent model behaviors on cloud.

Signed-off-by: Jacob Howard <jacob.howard@docker.com>
---
 pkg/environment/environment.go     | 61 ++++++++++++++++++++++++++++++
 pkg/inference/scheduling/loader.go |  7 ++++
 2 files changed, 68 insertions(+)
 create mode 100644 pkg/environment/environment.go

diff --git a/pkg/environment/environment.go b/pkg/environment/environment.go
new file mode 100644
index 0000000..397551c
--- /dev/null
+++ b/pkg/environment/environment.go
@@ -0,0 +1,61 @@
+package environment
+
+import (
+	"os"
+	"path/filepath"
+	"runtime"
+	"sync"
+)
+
+// Environment encodes the operating environment for the model runner.
+type Environment uint8
+
+const (
+	// EnvironmentUnknown represents an unknown environment in which basic,
+	// non-specialized defaults should be used.
+	EnvironmentUnknown Environment = iota
+	// EnvironmentDesktop represents a Docker Desktop environment.
+	EnvironmentDesktop
+	// EnvironmentMoby represents a Moby engine environment, if installed via
+	// the model CLI.
+	EnvironmentMoby
+	// EnvironmentCloud represents a Docker Cloud environment, if installed via
+	// the model CLI.
+	EnvironmentCloud
+)
+
+// environment is the cached environment.
+var environment Environment
+
+// environmentOnce guards initialization of environment.
+var environmentOnce sync.Once
+
+// isDockerBackend checks if an executable path is com.docker.backend.
+func isDockerBackend(path string) bool {
+	leaf := filepath.Base(path)
+	if runtime.GOOS == "windows" {
+		return leaf == "com.docker.backend.exe"
+	}
+	return leaf == "com.docker.backend"
+}
+
+// Get returns the current environment type.
+func Get() Environment {
+	environmentOnce.Do(func() {
+		// Check if we're running in a Docker Desktop backend process.
+		if executable, err := os.Executable(); err == nil && isDockerBackend(executable) {
+			environment = EnvironmentDesktop
+			return
+		}
+
+		// Look for a MODEL_RUNNER_ENVIRONMENT variable. If none is set or it's
+		// invalid, then leave the environment unknown.
+		switch os.Getenv("MODEL_RUNNER_ENVIRONMENT") {
+		case "moby":
+			environment = EnvironmentMoby
+		case "cloud":
+			environment = EnvironmentCloud
+		}
+	})
+	return environment
+}
diff --git a/pkg/inference/scheduling/loader.go b/pkg/inference/scheduling/loader.go
index ebf0681..536bd80 100644
--- a/pkg/inference/scheduling/loader.go
+++ b/pkg/inference/scheduling/loader.go
@@ -4,9 +4,11 @@ import (
 	"context"
 	"errors"
 	"fmt"
+	"os"
 	"runtime"
 	"time"
 
+	"github.com/docker/model-runner/pkg/environment"
 	"github.com/docker/model-runner/pkg/inference"
 	"github.com/docker/model-runner/pkg/inference/models"
 	"github.com/docker/model-runner/pkg/logging"
@@ -110,7 +112,12 @@ func newLoader(
 	// VRAM size here (and potentially even reserving a portion of it) and
 	// computing model size through estimation (using parameter count and
 	// quantization data type size).
+	//
+	// HACK: On GPU-enabled cloud engines, we'll temporarily bump this to 2.
 	totalMemory := uint64(1)
+	if environment.Get() == environment.EnvironmentCloud && os.Getenv("NVIDIA_VISIBLE_DEVICES") != "" {
+		totalMemory = 2
+	}
 
 	// Create the loader.
 	l := &loader{