@nghyane/arcane 0.1.22 → 0.1.23

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## [Unreleased]
 
+## [0.1.23] - 2026-03-08
+
+### Fixed
+
+- Fix Python setup installing packages into system Python instead of managed venv, causing "kernel unavailable" even after install
+- Fix missing `ensurepip` step when managed venv lacks pip
+- Fix misleading error message to point users to `arcane setup python`
+
 ## [0.1.22] - 2026-03-08
 
 ### Changed

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@nghyane/arcane",
-	"version": "0.1.22",
+	"version": "0.1.23",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/nghyane/arcane",
 	"author": "Can Bölük",

package/src/cli/setup-cli.ts

@@ -160,7 +160,18 @@ async function installPythonPackages(
 	pythonPath: string,
 	uvPath?: string,
 	pipPath?: string,
+	usingManagedEnv?: boolean,
 ): Promise<{ success: boolean; usedManagedEnv: boolean }> {
+	const managedPython = managedPythonPath();
+	const hasManagedEnv = await Bun.file(managedPython).exists();
+
+	// If the managed venv already exists, install directly into it.
+	// resolvePythonRuntime prefers managed venv over system Python,
+	// so installing into system Python would be invisible to the check.
+	if (hasManagedEnv || usingManagedEnv) {
+		return installIntoManagedEnv(packages, pythonPath, uvPath);
+	}
+
 	if (uvPath) {
 		console.log(chalk.dim(`Installing via uv: ${packages.join(" ")}`));
 		const result = await $`${uvPath} pip install ${packages}`.nothrow();
@@ -178,24 +189,35 @@ async function installPythonPackages(
 	}
 
 	console.log(chalk.dim(`Falling back to managed virtual environment: ${MANAGED_PYTHON_ENV}`));
+	return installIntoManagedEnv(packages, pythonPath, uvPath);
+}
+
+async function installIntoManagedEnv(
+	packages: string[],
+	pythonPath: string,
+	uvPath?: string,
+): Promise<{ success: boolean; usedManagedEnv: boolean }> {
+	console.log(chalk.dim(`Installing into managed environment: ${MANAGED_PYTHON_ENV}`));
 
 	if (uvPath) {
-		const createEnv = await $`${uvPath} venv ${MANAGED_PYTHON_ENV}`.quiet().nothrow();
+		// Ensure venv exists (no-op if already created)
+		await $`${uvPath} venv ${MANAGED_PYTHON_ENV}`.quiet().nothrow();
+		const result = await $`${uvPath} pip install --python ${MANAGED_PYTHON_ENV} ${packages}`.nothrow();
+		return { success: result.exitCode === 0, usedManagedEnv: true };
+	}
+
+	const managedPython = managedPythonPath();
+	if (!(await Bun.file(managedPython).exists())) {
+		const createEnv = await $`${pythonPath} -m venv ${MANAGED_PYTHON_ENV}`.quiet().nothrow();
 		if (createEnv.exitCode !== 0) {
 			return { success: false, usedManagedEnv: true };
 		}
-		const installInManagedEnv = await $`${uvPath} pip install --python ${MANAGED_PYTHON_ENV} ${packages}`.nothrow();
-		return { success: installInManagedEnv.exitCode === 0, usedManagedEnv: true };
 	}
 
-	const createEnv = await $`${pythonPath} -m venv ${MANAGED_PYTHON_ENV}`.quiet().nothrow();
-	if (createEnv.exitCode !== 0) {
-		return { success: false, usedManagedEnv: true };
-	}
-
-	const managedPython = managedPythonPath();
-	const installInManagedEnv = await $`${managedPython} -m pip install ${packages}`.nothrow();
-	return { success: installInManagedEnv.exitCode === 0, usedManagedEnv: true };
+	// Ensure pip is available in the managed env
+	await $`${managedPython} -m ensurepip`.quiet().nothrow();
+	const result = await $`${managedPython} -m pip install ${packages}`.nothrow();
+	return { success: result.exitCode === 0, usedManagedEnv: true };
 }
 
 /**
@@ -258,7 +280,13 @@ async function handlePythonSetup(flags: { json?: boolean; check?: boolean }): Pr
 	}
 
 	console.log("");
-	const install = await installPythonPackages(check.missingPackages, check.pythonPath, check.uvPath, check.pipPath);
+	const install = await installPythonPackages(
+		check.missingPackages,
+		check.pythonPath,
+		check.uvPath,
+		check.pipPath,
+		check.usingManagedEnv,
+	);
 
 	if (!install.success) {
 		console.error(chalk.red(`\n${theme.status.error} Installation failed`));

package/src/ipy/kernel.ts

@@ -129,8 +129,7 @@ export async function checkPythonKernelAvailability(cwd: string): Promise<Python
 		return {
 			ok: false,
 			pythonPath: runtime.pythonPath,
-			reason:
-				"kernel_gateway (jupyter-kernel-gateway) or ipykernel not installed. Run: python -m pip install jupyter_kernel_gateway ipykernel",
+			reason: "kernel_gateway (jupyter-kernel-gateway) or ipykernel not installed. Run: arcane setup python",
 		};
 	} catch (err: unknown) {
 		return { ok: false, reason: err instanceof Error ? err.message : String(err) };