claude-memory-agent 2.0.0 → 2.0.1

package/README.md

@@ -13,16 +13,22 @@ A persistent semantic memory system for Claude Code sessions. Stores memories, t
 
 ## Quick Start
 
-### 1. Prerequisites
+### 1. Prerequisites (Install These First!)
 
-- Node.js 16+ (for npm installation)
-- Python 3.9+
-- [Ollama](https://ollama.ai/) with `nomic-embed-text` model
+| Requirement | Download | Why Needed |
+|-------------|----------|------------|
+| **Python 3.9+** | https://python.org | Runs the agent |
+| **Ollama** | https://ollama.ai/download | Provides embeddings |
+| **Node.js 16+** | https://nodejs.org | For npm install |
+
+**After installing Ollama, run these commands:**
 
 ```bash
-# Install Ollama, then pull the embedding model
+# Download the embedding model (required!)
 ollama pull nomic-embed-text
-ollama serve  # Start Ollama server
+
+# Start Ollama (runs in background)
+ollama serve
 ```
 
 ### 2. Installation

package/bin/cli.js

@@ -113,16 +113,20 @@ COMMANDS:
   help        Show this help message
 
 QUICK START:
-  1. claude-memory-agent install   # Configure everything
-  2. claude-memory-agent start     # Start the agent
-  3. claude-memory-agent dashboard # Open web UI
+  1. Install Ollama:        https://ollama.ai/download
+  2. Pull embedding model:  ollama pull nomic-embed-text
+  3. Start Ollama:          ollama serve
+  4. Configure:             claude-memory-agent install
+  5. Start agent:           claude-memory-agent start
+  6. Open dashboard:        claude-memory-agent dashboard
 
 REQUIREMENTS:
-  - Python 3.9+
-  - Ollama with nomic-embed-text model (for embeddings)
-  - Claude Code (for full integration)
+  - Python 3.9+          (https://python.org)
+  - Ollama               (https://ollama.ai)
+  - nomic-embed-text     (ollama pull nomic-embed-text)
+  - Claude Code          (npm install -g @anthropic-ai/claude-code)
 
-For more info: https://github.com/yourusername/claude-memory-agent
+For more info: https://www.npmjs.com/package/claude-memory-agent
 `);
 }
 

package/bin/postinstall.js

@@ -175,36 +175,90 @@ async function main() {
     // Create .env file
     createEnvFile();
 
-    // Check Ollama (non-blocking)
+    // Check Ollama
     log('Checking Ollama...');
     const ollamaRunning = await checkOllama();
+
     if (ollamaRunning) {
         success('Ollama is running');
-    } else {
-        warn('Ollama not detected - embeddings require Ollama');
-        console.log('  Install from: https://ollama.ai/');
-        console.log('  Then run: ollama pull nomic-embed-text');
+        // Check if model is installed
+        const modelInstalled = await checkOllamaModel();
+        if (modelInstalled) {
+            success('Embedding model is ready');
+        } else {
+            warn('Embedding model not found');
+        }
     }
 
-    // Print next steps
+    // Print next steps based on what's missing
     header('Installation Complete!');
-    console.log('Next steps:');
-    console.log('');
-    console.log('  1. Run the setup wizard:');
-    console.log('     claude-memory-agent install');
-    console.log('');
-    console.log('  2. Start the agent:');
-    console.log('     claude-memory-agent start');
-    console.log('');
-    console.log('  3. Open the dashboard:');
-    console.log('     claude-memory-agent dashboard');
-    console.log('');
 
     if (!ollamaRunning) {
-        console.log('  For embeddings, install and start Ollama:');
-        console.log('     ollama pull nomic-embed-text');
-        console.log('     ollama serve');
+        // Ollama not installed - show big warning
+        console.log(`${colors.red}${colors.bold}╔════════════════════════════════════════════════════════════╗${colors.reset}`);
+        console.log(`${colors.red}${colors.bold}║  REQUIRED: Install Ollama for semantic search to work      ║${colors.reset}`);
+        console.log(`${colors.red}${colors.bold}╚════════════════════════════════════════════════════════════╝${colors.reset}`);
+        console.log('');
+        console.log('  Ollama is required for the memory agent to work properly.');
+        console.log('  Without it, semantic search will be disabled.');
+        console.log('');
+        console.log(`  ${colors.cyan}Step 1:${colors.reset} Download and install Ollama:`);
+        console.log(`          ${colors.bold}https://ollama.ai/download${colors.reset}`);
+        console.log('');
+        console.log(`  ${colors.cyan}Step 2:${colors.reset} After installing, open a terminal and run:`);
+        console.log(`          ${colors.bold}ollama pull nomic-embed-text${colors.reset}`);
+        console.log('');
+        console.log(`  ${colors.cyan}Step 3:${colors.reset} Start Ollama (it runs in background):`);
+        console.log(`          ${colors.bold}ollama serve${colors.reset}`);
+        console.log('');
+        console.log(`  ${colors.cyan}Step 4:${colors.reset} Then run the setup:`);
+        console.log(`          ${colors.bold}claude-memory-agent install${colors.reset}`);
         console.log('');
+    } else {
+        // Ollama running - show normal next steps
+        console.log('Next steps:');
+        console.log('');
+        console.log('  1. Run the setup wizard:');
+        console.log(`     ${colors.bold}claude-memory-agent install${colors.reset}`);
+        console.log('');
+        console.log('  2. Start the agent:');
+        console.log(`     ${colors.bold}claude-memory-agent start${colors.reset}`);
+        console.log('');
+        console.log('  3. Open the dashboard:');
+        console.log(`     ${colors.bold}claude-memory-agent dashboard${colors.reset}`);
+        console.log('');
+    }
+}
+
+// Check if embedding model is installed in Ollama
+async function checkOllamaModel() {
+    try {
+        const http = require('http');
+        return new Promise((resolve) => {
+            const req = http.get('http://localhost:11434/api/tags', { timeout: 2000 }, (res) => {
+                let data = '';
+                res.on('data', chunk => data += chunk);
+                res.on('end', () => {
+                    try {
+                        const json = JSON.parse(data);
+                        const models = json.models || [];
+                        const hasModel = models.some(m =>
+                            m.name && m.name.includes('nomic-embed-text')
+                        );
+                        resolve(hasModel);
+                    } catch (e) {
+                        resolve(false);
+                    }
+                });
+            });
+            req.on('error', () => resolve(false));
+            req.on('timeout', () => {
+                req.destroy();
+                resolve(false);
+            });
+        });
+    } catch (e) {
+        return false;
     }
 }
 

package/install.py

@@ -276,7 +276,22 @@ def check_ollama() -> bool:
             return True
     except Exception:
         pass
-    print_warning("Ollama not detected - embeddings will be disabled until Ollama is running")
+
+    print_warning("Ollama not detected")
+    print("")
+    print("  " + "="*56)
+    print("  OLLAMA REQUIRED FOR SEMANTIC SEARCH")
+    print("  " + "="*56)
+    print("")
+    print("  The memory agent needs Ollama for embeddings.")
+    print("  Without it, semantic search will not work.")
+    print("")
+    print("  To install Ollama:")
+    print("    1. Download from: https://ollama.ai/download")
+    print("    2. Install and run: ollama pull nomic-embed-text")
+    print("    3. Start Ollama: ollama serve")
+    print("    4. Re-run this installer")
+    print("")
     return False
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-memory-agent",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Persistent semantic memory system for Claude Code sessions with anti-hallucination grounding",
   "keywords": [
     "claude",
@@ -12,16 +12,8 @@
     "embeddings",
     "ollama"
   ],
-  "author": "Your Name",
+  "author": "Claude Memory Agent Contributors",
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/yourusername/claude-memory-agent.git"
-  },
-  "homepage": "https://github.com/yourusername/claude-memory-agent#readme",
-  "bugs": {
-    "url": "https://github.com/yourusername/claude-memory-agent/issues"
-  },
   "bin": {
     "claude-memory-agent": "./bin/cli.js",
     "claude-memory": "./bin/cli.js"