@lincoln504/pi-research 0.1.7 → 0.1.10

package/README.md

@@ -67,9 +67,25 @@ pi install .
 
 ## Platform Setup
 
-**macOS/Linux** — Install and start Docker. Ensure your user is in the `docker` group on Linux.
+**macOS** — Install Docker Desktop and start it from Applications.
+
+**Linux** — Install Docker and add your user to the docker group:
+```bash
+# Install Docker
+sudo apt-get update && sudo apt-get install -y docker.io
+
+# Start Docker
+sudo systemctl start docker
+sudo systemctl enable docker
+
+# Add your user to docker group (then log out and back in)
+sudo usermod -aG docker $USER
+```
+
 **Windows** — Install Docker Desktop (Linux containers). Detecting named pipes is automatic.
 
+> **Note**: The first time you use `pi install` on a fresh system, Docker may not be running yet. The extension will check Docker when you actually use the research tool, not during install.
+
 ---
 
 ## Usage

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lincoln504/pi-research",
-  "version": "0.1.7",
-  "description": "Multi-agent research Deep Mode orchestration for pi. State-driven parallel researchers with web search, scraping, security databases, and Stack Exchange integration.",
+  "version": "0.1.10",
+  "description": "A set of web research tools (search, scrape, and others) and research agent system that uses them safely and efficiently.",
   "type": "module",
   "private": false,
   "main": "src/index.ts",
@@ -24,10 +24,9 @@
   },
   "keywords": [
     "pi",
-    "pi-package",
+    "pi-extension",
     "research",
     "agent",
-    "orchestration",
     "web-search",
     "scraping",
     "security",

package/src/index.ts

@@ -45,10 +45,13 @@ export default function (pi: ExtensionAPI) {
 
   // Notify user of Docker status and log file location when starting a new session
   pi.on('session_start', async (_event, ctx) => {
-    // Check Docker availability on startup
-    const dockerCheck = await checkDockerAvailability();
-    if (!dockerCheck.running) {
-      ctx.ui.notify(`pi-research: ${dockerCheck.error}`, 'warning');
+    // Skip Docker check during install to avoid errors on fresh systems
+    // Docker will be checked when research tool is first used
+    if (!process.env['PI_INSTALL_MODE']) {
+      const dockerCheck = await checkDockerAvailability();
+      if (!dockerCheck.running) {
+        ctx.ui.notify(`pi-research: ${dockerCheck.error}`, 'warning');
+      }
     }
 
     if (isVerboseFromEnv()) {

package/src/infrastructure/searxng-manager.ts

@@ -285,9 +285,19 @@ export async function verifyDockerInstalled(): Promise<{ installed: boolean; run
   if (
     lastError.includes('ENOENT') ||
     lastError.includes('ECONNREFUSED') ||
-    lastError.includes('The system cannot find the file specified')
+    lastError.includes('The system cannot find the file specified') ||
+    lastError.includes('EACCES') ||
+    lastError.includes('permission')
   ) {
-    return { installed: true, running: false, error: 'Docker daemon is not running. Please start Docker.' };
+    let errorMsg = 'Docker daemon is not running or inaccessible.';
+    if (process.platform === 'linux') {
+      errorMsg += ' On Linux, run: sudo systemctl start docker && sudo usermod -aG docker $USER. Then log out and back in.';
+    } else if (process.platform === 'darwin') {
+      errorMsg += ' Start Docker Desktop from Applications.';
+    } else if (process.platform === 'win32') {
+      errorMsg += ' Start Docker Desktop from the Start menu.';
+    }
+    return { installed: true, running: false, error: errorMsg };
   }
 
   return { installed: false, running: false, error: `Docker not found or inaccessible: ${lastError}` };