bilisum 1.13.2 → 1.13.3

package/README.md

@@ -1,11 +1,11 @@
 # BiliSum
 
-`bilisum` starts BiliSum from npx with the official Docker image.
+`bilisum` starts the local BiliSum browser service from npx.
 
 ```bash
 npx bilisum
-npx bilisum start --port 3839 --pull
-npx bilisum docker
+npx bilisum start --port 3839
+npx bilisum doctor
 ```
 
-Docker Desktop is required. The desktop app is still distributed through GitHub Releases.
+Python 3.12 is required. On first run, BiliSum creates a managed Python virtual environment under the user's local app data directory.

package/bin/bilisum.js

@@ -1,16 +1,17 @@
 #!/usr/bin/env node
 
-const { execFileSync, spawn, spawnSync } = require("node:child_process");
-const { existsSync, readFileSync } = require("node:fs");
-const { join } = require("node:path");
+const { spawn, spawnSync } = require("node:child_process");
+const { existsSync, mkdirSync, readFileSync } = require("node:fs");
+const { dirname, join } = require("node:path");
 
 const RELEASES_URL = "https://github.com/lycohana/BiliSum/releases/latest";
 const REPO_URL = "https://github.com/lycohana/BiliSum";
-const DEFAULT_IMAGE = "lycohana/bilisum:latest";
 const DEFAULT_PORT = "3838";
+const PACKAGE_ROOT = join(__dirname, "..");
+const RUNTIME_ROOT = join(PACKAGE_ROOT, "runtime");
 
 function readVersion() {
-  const packagePath = join(__dirname, "..", "package.json");
+  const packagePath = join(PACKAGE_ROOT, "package.json");
   if (!existsSync(packagePath)) {
     return "unknown";
   }
@@ -24,20 +25,19 @@ function printHelp() {
   console.log("AI 视频总结与知识库工具，深度优化 B 站体验，同时支持 YouTube 和本地视频。");
   console.log("");
   console.log("Usage:");
-  console.log("  npx bilisum                         Start BiliSum with Docker");
-  console.log("  npx bilisum start [options]          Start BiliSum with Docker");
+  console.log("  npx bilisum                         Start the local BiliSum service");
+  console.log("  npx bilisum start [options]          Start the local BiliSum service");
+  console.log("  npx bilisum doctor                   Check Python/runtime setup");
   console.log("  npx bilisum --version                Print package version");
   console.log("  npx bilisum release                  Open the latest GitHub release");
-  console.log("  npx bilisum docker                   Print the Docker command");
   console.log("");
   console.log("Options:");
-  console.log("  --port <port>                        Host port, default 3838");
-  console.log("  --image <image>                      Docker image, default lycohana/bilisum:latest");
-  console.log("  --name <name>                        Container name, default bilisum");
-  console.log("  --data <volume-or-path>              Data volume/path, default bilisum-data");
+  console.log("  --host <host>                        Host, default 127.0.0.1");
+  console.log("  --port <port>                        Port, default 3838");
+  console.log("  --python <path>                      Python 3.12 executable");
+  console.log("  --data <path>                        Data directory");
   console.log("  --env KEY=VALUE                      Pass an environment variable");
-  console.log("  --pull                               Pull the image before starting");
-  console.log("  --detach, -d                         Run container in background");
+  console.log("  --reinstall                          Recreate the managed Python venv");
   console.log("  --no-open                            Do not open the browser");
   console.log("");
   console.log(`Latest release: ${RELEASES_URL}`);
@@ -46,32 +46,29 @@ function printHelp() {
 
 function parseStartOptions(args) {
   const options = {
+    host: process.env.BILISUM_HOST || "127.0.0.1",
     port: process.env.BILISUM_PORT || DEFAULT_PORT,
-    image: process.env.BILISUM_DOCKER_IMAGE || DEFAULT_IMAGE,
-    name: process.env.BILISUM_CONTAINER_NAME || "bilisum",
-    data: process.env.BILISUM_DATA || "bilisum-data",
+    python: process.env.BILISUM_PYTHON || "",
+    data: process.env.BILISUM_DATA || defaultDataDir(),
     env: [],
-    pull: false,
-    detach: false,
+    reinstall: false,
     open: true,
   };
 
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
-    if (arg === "--port" || arg === "-p") {
+    if (arg === "--host") {
+      options.host = readOptionValue(args, ++index, arg);
+    } else if (arg === "--port" || arg === "-p") {
       options.port = readOptionValue(args, ++index, arg);
-    } else if (arg === "--image") {
-      options.image = readOptionValue(args, ++index, arg);
-    } else if (arg === "--name") {
-      options.name = readOptionValue(args, ++index, arg);
+    } else if (arg === "--python") {
+      options.python = readOptionValue(args, ++index, arg);
     } else if (arg === "--data") {
       options.data = readOptionValue(args, ++index, arg);
     } else if (arg === "--env" || arg === "-e") {
       options.env.push(readOptionValue(args, ++index, arg));
-    } else if (arg === "--pull") {
-      options.pull = true;
-    } else if (arg === "--detach" || arg === "-d") {
-      options.detach = true;
+    } else if (arg === "--reinstall") {
+      options.reinstall = true;
     } else if (arg === "--no-open") {
       options.open = false;
     } else {
@@ -90,68 +87,141 @@ function readOptionValue(args, index, option) {
   return value;
 }
 
-function dockerCommand(options) {
-  const args = ["run", "--rm"];
-  if (options.detach) {
-    args.push("-d");
-  } else {
-    args.push("-it");
-  }
-
-  args.push("--name", options.name);
-  args.push("-p", `${options.port}:3838`);
-  args.push("-v", `${options.data}:/data`);
-
-  const envKeys = [
-    "VIDEO_SUM_LLM_ENABLED",
-    "VIDEO_SUM_LLM_BASE_URL",
-    "VIDEO_SUM_LLM_MODEL",
-    "VIDEO_SUM_LLM_API_KEY",
-    "VIDEO_SUM_TRANSCRIPTION_PROVIDER",
-    "VIDEO_SUM_SILICONFLOW_ASR_BASE_URL",
-    "VIDEO_SUM_SILICONFLOW_ASR_MODEL",
-    "VIDEO_SUM_SILICONFLOW_ASR_API_KEY",
-    "VIDEO_SUM_YTDLP_COOKIES_FILE",
-  ];
-  for (const key of envKeys) {
-    if (process.env[key]) {
-      args.push("-e", `${key}=${process.env[key]}`);
-    }
+function defaultBaseDir() {
+  if (process.env.BILISUM_NPX_HOME) {
+    return process.env.BILISUM_NPX_HOME;
   }
-  for (const value of options.env) {
-    args.push("-e", value);
+  if (process.platform === "win32") {
+    return join(process.env.LOCALAPPDATA || process.env.USERPROFILE || process.cwd(), "BiliSum", "npx");
   }
+  return join(process.env.XDG_DATA_HOME || join(process.env.HOME || process.cwd(), ".local", "share"), "bilisum", "npx");
+}
+
+function defaultDataDir() {
+  return join(defaultBaseDir(), "data");
+}
+
+function venvDir() {
+  return join(defaultBaseDir(), `venv-${readVersion()}`);
+}
 
-  args.push(options.image);
-  return args;
+function pythonInVenv() {
+  return process.platform === "win32" ? join(venvDir(), "Scripts", "python.exe") : join(venvDir(), "bin", "python");
 }
 
-function printDockerCommand(options = parseStartOptions([])) {
-  console.log(["docker", ...dockerCommand(options)].join(" "));
+function findPython(explicitPython) {
+  const candidates = [];
+  if (explicitPython) {
+    candidates.push({ command: explicitPython, args: [] });
+  }
+  if (process.platform === "win32") {
+    candidates.push({ command: "py", args: ["-3.12"] });
+  }
+  candidates.push({ command: "python3.12", args: [] });
+  candidates.push({ command: "python3", args: [] });
+  candidates.push({ command: "python", args: [] });
+
+  for (const candidate of candidates) {
+    const check = spawnSync(candidate.command, [
+      ...candidate.args,
+      "-c",
+      "import sys; raise SystemExit(0 if sys.version_info >= (3, 12) else 1)",
+    ], { stdio: "ignore", windowsHide: true });
+    if (check.status === 0) {
+      return candidate;
+    }
+  }
+
+  throw new Error("Python 3.12 was not found. Install Python 3.12 or pass --python <path>.");
 }
 
-function ensureDocker() {
-  const result = spawnSync("docker", ["--version"], { stdio: "ignore", windowsHide: true });
+function runChecked(command, args, options = {}) {
+  const result = spawnSync(command, args, {
+    stdio: "inherit",
+    windowsHide: false,
+    ...options,
+  });
+  if (result.error) {
+    throw result.error;
+  }
   if (result.status !== 0) {
-    throw new Error("Docker was not detected. Install Docker Desktop, then run npx bilisum again.");
+    throw new Error(`${command} ${args.join(" ")} failed with exit code ${result.status}`);
+  }
+}
+
+function ensureRuntime() {
+  if (!existsSync(join(RUNTIME_ROOT, "apps", "service", "pyproject.toml"))) {
+    throw new Error("BiliSum runtime files are missing from this npm package. Please reinstall bilisum.");
+  }
+  if (!existsSync(join(RUNTIME_ROOT, "apps", "web", "static", "index.html"))) {
+    throw new Error("BiliSum web static files are missing from this npm package. Please reinstall bilisum.");
   }
 }
 
+function ensureVenv(options) {
+  ensureRuntime();
+  const pythonPath = pythonInVenv();
+  const marker = join(venvDir(), ".bilisum-installed");
+  if (existsSync(pythonPath) && existsSync(marker) && !options.reinstall) {
+    return pythonPath;
+  }
+
+  const sourcePython = findPython(options.python);
+  mkdirSync(dirname(venvDir()), { recursive: true });
+
+  console.log("Preparing BiliSum Python runtime. This may take a minute on first run...");
+  runChecked(sourcePython.command, [...sourcePython.args, "-m", "venv", venvDir()]);
+
+  runChecked(pythonPath, ["-m", "pip", "install", "--upgrade", "pip", "setuptools", "wheel", "hatchling"]);
+  runChecked(pythonPath, [
+    "-m",
+    "pip",
+    "install",
+    join(RUNTIME_ROOT, "packages", "infra"),
+    join(RUNTIME_ROOT, "packages", "core"),
+    join(RUNTIME_ROOT, "apps", "service"),
+  ]);
+
+  mkdirSync(venvDir(), { recursive: true });
+  require("node:fs").writeFileSync(marker, readVersion(), "utf8");
+  return pythonPath;
+}
+
 function startService(args) {
   const options = parseStartOptions(args);
-  ensureDocker();
+  const pythonPath = ensureVenv(options);
+  const dataDir = options.data;
+  const cacheDir = join(dataDir, "cache");
+  const tasksDir = join(dataDir, "tasks");
+  mkdirSync(cacheDir, { recursive: true });
+  mkdirSync(tasksDir, { recursive: true });
 
-  if (options.pull) {
-    execFileSync("docker", ["pull", options.image], { stdio: "inherit" });
+  const env = {
+    ...process.env,
+    VIDEO_SUM_HOST: options.host,
+    VIDEO_SUM_PORT: options.port,
+    VIDEO_SUM_APP_DATA_ROOT: dataDir,
+    VIDEO_SUM_DATA_DIR: dataDir,
+    VIDEO_SUM_CACHE_DIR: cacheDir,
+    VIDEO_SUM_TASKS_DIR: tasksDir,
+    VIDEO_SUM_DATABASE_URL: `sqlite:///${join(dataDir, "video_sum.db").replace(/\\/g, "/")}`,
+    VIDEO_SUM_WEB_STATIC_DIR: join(RUNTIME_ROOT, "apps", "web", "static"),
+  };
+  for (const item of options.env) {
+    const equals = item.indexOf("=");
+    if (equals <= 0) {
+      throw new Error(`Invalid --env value: ${item}`);
+    }
+    env[item.slice(0, equals)] = item.slice(equals + 1);
   }
 
-  const url = `http://127.0.0.1:${options.port}`;
+  const url = `http://${options.host}:${options.port}`;
   console.log(`Starting BiliSum at ${url}`);
-  console.log("");
-  printDockerCommand(options);
+  console.log(`Data directory: ${dataDir}`);
   console.log("");
 
-  const child = spawn("docker", dockerCommand(options), {
+  const child = spawn(pythonPath, ["-m", "video_sum_service"], {
+    env,
     stdio: "inherit",
     windowsHide: false,
   });
@@ -169,6 +239,17 @@ function startService(args) {
   });
 }
 
+function doctor(args) {
+  const options = parseStartOptions(args);
+  ensureRuntime();
+  const python = findPython(options.python);
+  console.log(`BiliSum package: ${readVersion()}`);
+  console.log(`Python command: ${[python.command, ...python.args].join(" ")}`);
+  console.log(`Runtime root:   ${RUNTIME_ROOT}`);
+  console.log(`Venv:           ${venvDir()}`);
+  console.log(`Data:           ${options.data}`);
+}
+
 function openUrl(url) {
   const platform = process.platform;
   const command = platform === "win32" ? "cmd" : platform === "darwin" ? "open" : "xdg-open";
@@ -198,6 +279,11 @@ function main() {
       return;
     }
 
+    if (command === "doctor") {
+      doctor(args);
+      return;
+    }
+
     if (command === "help" || command === "-h" || command === "--help") {
       printHelp();
       return;
@@ -218,11 +304,6 @@ function main() {
       return;
     }
 
-    if (command === "docker") {
-      printDockerCommand(parseStartOptions(args));
-      return;
-    }
-
     throw new Error(`Unknown command: ${command}`);
   } catch (error) {
     console.error(error instanceof Error ? error.message : String(error));

package/package.json

@@ -1,14 +1,19 @@
 {
   "name": "bilisum",
-  "version": "1.13.2",
-  "description": "Start BiliSum from npx with the official Docker image.",
+  "version": "1.13.3",
+  "description": "Start the local BiliSum service from npx.",
   "bin": {
     "bilisum": "bin/bilisum.js"
   },
   "files": [
     "bin",
+    "runtime",
     "README.md"
   ],
+  "scripts": {
+    "prepack": "node scripts/prepare-runtime.js",
+    "postpack": "node scripts/cleanup-runtime.js"
+  },
   "engines": {
     "node": ">=18"
   },

package/runtime/VERSION

@@ -0,0 +1 @@
+1.13.3

package/runtime/apps/service/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["hatchling>=1.27.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "video-sum-service"
+version = "1.13.3"
+description = "Local backend service for the video summarizer."
+requires-python = ">=3.12"
+dependencies = [
+  "fastapi>=0.115,<1.0",
+  "uvicorn[standard]>=0.34,<1.0",
+  "pydantic>=2.10,<3.0",
+  "video-sum-core",
+  "video-sum-infra",
+]
+
+[project.optional-dependencies]
+knowledge = [
+  "chromadb>=1.0.0",
+  "sentence-transformers>=3.0",
+]
+
+[project.scripts]
+video-sum-service = "video_sum_service.main:run"
+video-sum-transcribe-worker = "video_sum_service.transcribe_worker:run"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/video_sum_service"]

package/runtime/apps/service/src/video_sum_service/__init__.py

@@ -0,0 +1 @@
+"""Local backend service package."""

package/runtime/apps/service/src/video_sum_service/__main__.py

@@ -0,0 +1,5 @@
+from video_sum_service.main import run
+
+
+if __name__ == "__main__":
+    run()