traicebox 0.1.11 → 0.1.13

package/README.md

@@ -17,7 +17,7 @@
 
 ## Prerequisites
 
-Traicebox requires [Docker](https://www.docker.com/) and [Docker Compose](https://docs.docker.com/compose/) to be installed and running on your system.
+Traicebox requires either [Docker](https://www.docker.com/) with Docker Compose or [Podman](https://podman.io/) with Podman Compose to be installed and running on your system.
 
 ## Installation
 
@@ -219,10 +219,11 @@ By default, it is located at:
 
 You can customize the stack behavior by creating or editing `${TRAICEBOX_HOME}/traicebox.yaml`.
 
-| Option | Type     | Default     | Description                                                  |
-| :----- | :------- | :---------- | :----------------------------------------------------------- |
-| `host` | `string` | `127.0.0.1` | The host address that Traicebox services will bind to.       |
-| `port` | `number` | `5483`      | The port that Traicebox services will be accessible through. |
+| Option    | Type     | Default     | Description                                                                      |
+| :-------- | :------- | :---------- | :------------------------------------------------------------------------------- |
+| `host`    | `string` | `127.0.0.1` | The host address that Traicebox services will bind to.                           |
+| `port`    | `number` | `5483`      | The port that Traicebox services will be accessible through.                     |
+| `runtime` | `string` | auto-detect | Optional. Force Traicebox to use `docker` or `podman` instead of auto-detecting. |
 
 Example:
 

package/dist/{compose-bfc4a606.yml → compose-r1mahfqb.yml}

@@ -137,7 +137,7 @@ services:
       LANGFUSE_INIT_USER_NAME: ${LANGFUSE_INIT_USER_NAME}
       LANGFUSE_INIT_USER_PASSWORD: ${LANGFUSE_INIT_USER_PASSWORD}
     healthcheck:
-      test: ["CMD", "node", "-e", "const host = process.env.HOSTNAME || 'localhost'; fetch('http://' + host + ':3000/api/auth/csrf').then(async (r) => { const ok = r.ok && (await r.text()).includes('csrfToken'); process.exit(ok ? 0 : 1); }).catch(() => process.exit(1))"]
+      test: ["CMD", "node", "-e", "const { hostname } = require('node:os'); fetch('http://' + hostname() + ':3000/api/auth/csrf').then(async (r) => { const ok = r.ok && (await r.text()).includes('csrfToken'); process.exit(ok ? 0 : 1); }).catch(() => process.exit(1))"]
       interval: 5s
       timeout: 5s
       retries: 24

package/dist/index.js

@@ -12894,32 +12894,73 @@ var LANGFUSE_HOST = "langfuse.localhost";
 
 // cli/lib/docker.ts
 import { spawn } from "node:child_process";
-async function ensureDockerReady(executor = executeCommand) {
-  const composeResult = await executor(["docker", "compose", "version"]);
-  validateDockerComposeResult(composeResult);
-  const engineResult = await executor([
-    "docker",
-    "info",
-    "--format",
-    "{{.ServerVersion}}"
-  ]);
-  validateDockerEngineResult(engineResult);
-}
-function validateDockerComposeResult(result) {
-  if (result.errorCode === "ENOENT") {
-    throw new Error("Docker CLI is not available. Install Docker and try again.");
+var SUPPORTED_CONTAINER_RUNTIME_COMMANDS = [
+  "docker",
+  "podman"
+];
+var SUPPORTED_RUNTIMES = [
+  { command: "docker" },
+  { command: "podman" }
+];
+async function ensureDockerReady(executor = executeCommand, preferredRuntime) {
+  if (preferredRuntime) {
+    return ensurePreferredRuntimeReady(preferredRuntime, executor);
+  }
+  let sawInstalledRuntime = false;
+  let sawComposeCommand = false;
+  for (const runtime of SUPPORTED_RUNTIMES) {
+    const composeResult = await executor([
+      runtime.command,
+      "compose",
+      "version"
+    ]);
+    if (composeResult.errorCode === "ENOENT") {
+      continue;
+    }
+    sawInstalledRuntime = true;
+    if (composeResult.exitCode !== 0) {
+      continue;
+    }
+    sawComposeCommand = true;
+    const engineResult = await executor(getEngineProbeCommand(runtime.command));
+    if (engineResult.exitCode === 0) {
+      return runtime;
+    }
   }
-  if (result.exitCode !== 0) {
-    throw new Error("Docker Compose is not available. Check your Docker installation and try again.");
+  if (!sawInstalledRuntime) {
+    throw new Error("Neither Docker nor Podman CLI is available. Install one and try again.");
   }
+  if (!sawComposeCommand) {
+    throw new Error("Neither Docker Compose nor Podman Compose is available. Check your installation and try again.");
+  }
+  throw new Error("Docker or Podman is installed but the engine is not reachable. Start it and try again.");
 }
-function validateDockerEngineResult(result) {
-  if (result.errorCode === "ENOENT") {
-    throw new Error("Docker CLI is not available. Install Docker and try again.");
+async function ensurePreferredRuntimeReady(preferredRuntime, executor) {
+  const composeResult = await executor([
+    preferredRuntime,
+    "compose",
+    "version"
+  ]);
+  if (composeResult.errorCode === "ENOENT") {
+    throw new Error(`${displayRuntimeName(preferredRuntime)} CLI is not available. Install ${displayRuntimeName(preferredRuntime)} and try again.`);
+  }
+  if (composeResult.exitCode !== 0) {
+    throw new Error(`${displayRuntimeName(preferredRuntime)} Compose is not available. Check your ${displayRuntimeName(preferredRuntime)} installation and try again.`);
   }
-  if (result.exitCode !== 0) {
-    throw new Error("Docker is installed but the engine is not reachable. Start Docker and try again.");
+  const engineResult = await executor(getEngineProbeCommand(preferredRuntime));
+  if (engineResult.errorCode === "ENOENT") {
+    throw new Error(`${displayRuntimeName(preferredRuntime)} CLI is not available. Install ${displayRuntimeName(preferredRuntime)} and try again.`);
   }
+  if (engineResult.exitCode !== 0) {
+    throw new Error(`${displayRuntimeName(preferredRuntime)} is installed but the engine is not reachable. Start ${displayRuntimeName(preferredRuntime)} and try again.`);
+  }
+  return { command: preferredRuntime };
+}
+function displayRuntimeName(runtime) {
+  return runtime === "docker" ? "Docker" : "Podman";
+}
+function getEngineProbeCommand(runtime) {
+  return runtime === "docker" ? [runtime, "info", "--format", "{{.ServerVersion}}"] : [runtime, "info"];
 }
 async function executeCommand(command2) {
   try {
@@ -13053,6 +13094,7 @@ function initializeRuntime() {
     xdgConfigHome: env2.XDG_CONFIG_HOME
   });
   const configPath = join2(resolvedHome.home, "traicebox.yaml");
+  let containerRuntime;
   if (existsSync2(configPath)) {
     try {
       const configObj = import_yaml2.default.parse(readFileSync4(configPath, "utf-8"));
@@ -13063,6 +13105,7 @@ function initializeRuntime() {
         if (!env2.TRAICEBOX_PORT && (typeof configObj.port === "string" || typeof configObj.port === "number")) {
           env2.TRAICEBOX_PORT = String(configObj.port);
         }
+        containerRuntime = resolveConfiguredContainerRuntime(configObj.runtime);
       }
     } catch {
       fail(`Failed to parse config file: ${configPath}`);
@@ -13071,7 +13114,8 @@ function initializeRuntime() {
   runtimeContext = {
     home: resolvedHome.home,
     dev: resolvedHome.dev,
-    stackEnv: resolveStackEnv(env2)
+    stackEnv: resolveStackEnv(env2),
+    containerRuntime
   };
   return runtimeContext;
 }
@@ -13130,6 +13174,15 @@ function isTruthy(value) {
 function toAbsolutePath(cwd, value) {
   return isAbsolute(value) ? value : join2(cwd, value);
 }
+function resolveConfiguredContainerRuntime(value) {
+  if (value == null) {
+    return;
+  }
+  if (typeof value === "string" && SUPPORTED_CONTAINER_RUNTIME_COMMANDS.includes(value)) {
+    return value;
+  }
+  throw new Error("Invalid runtime in traicebox.yaml. Expected 'docker' or 'podman'.");
+}
 
 // cli/handlers/docker-lifecycle.ts
 var TMPDIR = process.env.TMPDIR ?? "/tmp";
@@ -13218,7 +13271,7 @@ function cleanupOpenAICompatibleApiKeySecretMaterialSync() {
     activeSecretDirectory = null;
   }
 }
-async function runDockerCompose(args, logs) {
+async function runDockerComposeWithRuntime(containerRuntime, args, logs) {
   const runtime = getRuntime();
   const env2 = {
     ...process.env,
@@ -13226,7 +13279,7 @@ async function runDockerCompose(args, logs) {
     [SECRET_FILE_ENV]: prepareOpenAICompatibleApiKeySecretFile()
   };
   try {
-    const proc = spawn2("docker", ["compose", ...args], {
+    const proc = spawn2(containerRuntime.command, ["compose", ...args], {
       cwd: runtime.home,
       env: env2,
       stdio: [
@@ -13258,7 +13311,7 @@ async function runDockerCompose(args, logs) {
       if (stderr.trim()) {
         process.stderr.write(stderr);
       }
-      fail(`docker compose ${args.join(" ")} failed with exit code ${exitCode}`);
+      fail(`${containerRuntime.command} compose ${args.join(" ")} failed with exit code ${exitCode}`);
     }
   } finally {
     activeDockerComposeProcess = null;
@@ -13299,7 +13352,8 @@ function installDockerLifecycleSignalHandlers() {
 }
 async function runStackCommand(command2, logs) {
   ensureActiveHomeExists();
-  await ensureDockerReady().catch((error) => {
+  const runtime = getRuntime();
+  const containerRuntime = await ensureDockerReady(undefined, runtime.containerRuntime).catch((error) => {
     fail(error instanceof Error ? error.message : String(error));
   });
   if (command2 === "start" || command2 === "restart") {
@@ -13318,17 +13372,17 @@ async function runStackCommand(command2, logs) {
       ...LONG_RUNNING_SERVICES
     ] : ["up", "-d", "--remove-orphans", "--wait", ...LONG_RUNNING_SERVICES];
     await runStep("Starting stack", logs, async () => {
-      await runDockerCompose(upArgs, logs);
+      await runDockerComposeWithRuntime(containerRuntime, upArgs, logs);
     });
     await runStep("Bootstrapping LiteLLM", logs, async () => {
-      await runDockerCompose(["run", "--rm", "--no-deps", "litellm-bootstrap"], logs);
+      await runDockerComposeWithRuntime(containerRuntime, ["run", "--rm", "--no-deps", "litellm-bootstrap"], logs);
     });
     printAccessInfo(command2);
     return;
   }
   const downArgs = command2 === "stop" ? ["stop"] : ["down", "--remove-orphans", "--volumes"];
   await runStep(command2 === "stop" ? "Stopping stack" : "Destroying stack", logs, async () => {
-    await runDockerCompose(downArgs, logs);
+    await runDockerComposeWithRuntime(containerRuntime, downArgs, logs);
   });
 }
 
@@ -13464,7 +13518,7 @@ import { fileURLToPath as fileURLToPath2 } from "node:url";
 var Caddyfile_default = "./Caddyfile-at2nzhxs.";
 
 // template/compose.yml
-var compose_default = "./compose-bfc4a606.yml";
+var compose_default = "./compose-r1mahfqb.yml";
 
 // template/langfuse-proxy/Dockerfile
 var Dockerfile_default = "./Dockerfile-bzexf8bh.";
@@ -13565,10 +13619,10 @@ async function writeDevelopmentDotenv(home, stackEnv) {
 
 // cli/handlers/setup.ts
 async function runSetup(force = false) {
-  await ensureDockerReady().catch((error) => {
+  const runtime = getRuntime();
+  await ensureDockerReady(undefined, runtime.containerRuntime).catch((error) => {
     fail(error instanceof Error ? error.message : String(error));
   });
-  const runtime = getRuntime();
   if (force) {
     rmSync2(runtime.home, { recursive: true, force: true });
   }
@@ -13603,28 +13657,28 @@ await yargs_default(hideBin(process.argv)).scriptName("traicebox").command("setu
   alias: "l",
   type: "boolean",
   default: false,
-  describe: "Show docker compose output while starting"
+  describe: "Show compose output while starting"
 }), async (argv) => {
   await runStackCommand("start", argv.logs);
 }).command("stop", "Stop the stack", (cmd) => cmd.option("logs", {
   alias: "l",
   type: "boolean",
   default: false,
-  describe: "Show docker compose output while stopping"
+  describe: "Show compose output while stopping"
 }), async (argv) => {
   await runStackCommand("stop", argv.logs);
 }).command("restart", "Recreate the stack and wait until it is ready", (cmd) => cmd.option("logs", {
   alias: "l",
   type: "boolean",
   default: false,
-  describe: "Show docker compose output while restarting"
+  describe: "Show compose output while restarting"
 }), async (argv) => {
   await runStackCommand("restart", argv.logs);
 }).command("destroy", "Remove the stack and local data volumes", (cmd) => cmd.option("logs", {
   alias: "l",
   type: "boolean",
   default: false,
-  describe: "Show docker compose output while destroying"
+  describe: "Show compose output while destroying"
 }), async (argv) => {
   await runStackCommand("destroy", argv.logs);
 }).command("models <command>", "Manage imported LiteLLM models", (cmd) => cmd.command("import-from-openai-api", "Import models from an OpenAI-compatible endpoint into LiteLLM config", (subcmd) => subcmd.option("endpoint", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "traicebox",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "A local developer stack for tracing and session tracking around LLM and AI model workflows",
   "license": "MIT",
   "author": "Fardjad Davari <public@fardjad.com>",
@@ -35,7 +35,7 @@
     "fix": "biome check --write . && dprint fmt"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.12",
+    "@biomejs/biome": "^2.4.13",
     "@types/bun": "^1.3.13",
     "@types/yargs": "^17.0.35",
     "dprint": "^0.54.0",