kyp-mem 0.2.0 → 0.2.1

package/README.md

@@ -1,21 +1,27 @@
 # KYP-MEM — Know Your Project Memory
 
-**Headless Obsidian for AI agents.** A markdown knowledge base with wikilinks, backlinks, tags, related notes, and a neon web UI — all powered by an MCP server so Claude (or any AI) can read and write your project knowledge directly.
+**Headless knowledge base for AI agents.** Markdown notes with wikilinks, backlinks, tags, related notes, and a neon web UI — all powered by an MCP server so Claude (or any AI) can read and write your project knowledge directly.
 
 ## Install
 
 ```bash
-pip install kyp-mem
+npx -y kyp-mem
+```
+
+Or install the command globally:
+
+```bash
+npm install -g kyp-mem
 ```
 
 ## Setup (3 commands)
 
 ```bash
 # 1. Choose where your vault (knowledge base) lives
-kyp-mem init
+npx -y kyp-mem init
 
 # 2. Connect to Claude Code — auto-configures MCP
-kyp-mem setup-claude
+npx -y kyp-mem setup-claude
 
 # 3. Restart Claude Code — done!
 #    kyp-mem now runs headlessly every session.
@@ -27,10 +33,10 @@ That's it. Claude now has `kyp_read`, `kyp_write`, `kyp_search`, and 7 other too
 ## Optional: Web UI
 
 ```bash
-kyp-mem ui
+npx -y kyp-mem ui
 ```
 
-Opens an Obsidian-like interface at `localhost:3333` with:
+Opens a rich interface at `localhost:3333` with:
 - Collapsible folder tree
 - Rendered markdown with syntax highlighting
 - Clickable `[[wikilinks]]`
@@ -50,7 +56,7 @@ Opens an Obsidian-like interface at `localhost:3333` with:
 ```
 
 - **Headless by default** — runs as an MCP server (stdio), no GUI needed
-- **Markdown files on disk** — same format as Obsidian, no database
+- **Markdown files on disk** — plain `.md` files with YAML frontmatter, no database
 - **In-memory index** — links, backlinks, tags, search, similarity scoring
 - **Web UI optional** — `kyp-mem ui` when you want to browse visually
 
@@ -83,7 +89,7 @@ Opens an Obsidian-like interface at `localhost:3333` with:
 
 ## Note Format
 
-Standard markdown with YAML frontmatter — same as Obsidian:
+Standard markdown with YAML frontmatter:
 
 ```markdown
 ---
@@ -108,8 +114,8 @@ If you prefer to configure manually instead of using `setup-claude`:
 {
   "mcpServers": {
     "kyp-mem": {
-      "command": "kyp-mem",
-      "args": ["serve"],
+      "command": "npx",
+      "args": ["-y", "kyp-mem", "serve"],
       "env": {
         "KYP_VAULT": "~/.kyp-mem/vault"
       }
@@ -134,12 +140,10 @@ Add to `~/.claude/settings.json` (global) or `.claude/settings.json` (per-projec
         └── ...
 ```
 
-## Publishing to PyPI
+## Publishing to npm
 
 ```bash
-pip install build twine
-python3 -m build
-twine upload dist/*
+npm publish
 ```
 
 ## License

package/bin/cli.mjs

@@ -1,33 +1,68 @@
 #!/usr/bin/env node
 
-import { execFileSync, execSync } from "child_process";
+import { spawnSync } from "child_process";
+import { delimiter, dirname, resolve } from "path";
+import { fileURLToPath } from "url";
 
 const args = process.argv.slice(2);
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const root = resolve(__dirname, "..");
 
-function tryRun(cmd, cmdArgs) {
-  try {
-    execFileSync(cmd, cmdArgs, { stdio: "inherit" });
-    return true;
-  } catch {
-    return false;
+const env = {
+  ...process.env,
+  PYTHONPATH: process.env.PYTHONPATH
+    ? `${root}${delimiter}${process.env.PYTHONPATH}`
+    : root,
+};
+
+function run(command, cmdArgs, stdio = "ignore") {
+  return spawnSync(command, cmdArgs, { stdio, env });
+}
+
+function pythonCandidates() {
+  if (process.env.KYP_MEM_PYTHON) {
+    return [[process.env.KYP_MEM_PYTHON, []]];
+  }
+
+  const candidates = [
+    ["python3", []],
+    ["python", []],
+  ];
+
+  if (process.platform === "win32") {
+    candidates.unshift(["py", ["-3"]]);
+  }
+
+  return candidates;
+}
+
+function findPython() {
+  for (const [command, prefixArgs] of pythonCandidates()) {
+    const result = run(command, [...prefixArgs, "--version"]);
+    if (result.status === 0) {
+      return [command, prefixArgs];
+    }
   }
+
+  return null;
 }
 
-// Try the installed kyp-mem binary first
-if (tryRun("kyp-mem", args)) process.exit(0);
+const python = findPython();
 
-// Fallback: python3 -m kyp_mem.cli
-if (tryRun("python3", ["-m", "kyp_mem.cli", ...args])) process.exit(0);
+if (python) {
+  const [command, prefixArgs] = python;
+  const result = run(command, [...prefixArgs, "-m", "kyp_mem.cli", ...args], "inherit");
 
-// Fallback: python -m kyp_mem.cli
-if (tryRun("python", ["-m", "kyp_mem.cli", ...args])) process.exit(0);
+  if (result.signal) {
+    process.kill(process.pid, result.signal);
+  }
+
+  process.exit(result.status ?? 1);
+}
 
 console.error("");
-console.error("  \x1b[31mError:\x1b[0m kyp-mem Python package not found.");
+console.error("  \x1b[31mError:\x1b[0m Python 3 was not found.");
 console.error("");
-console.error("  Install it:");
-console.error("    \x1b[33mpip install kyp-mem\x1b[0m");
-console.error("  Or from source:");
-console.error("    \x1b[33mpip install git+https://github.com/Adhithya-Karthikeyan/KYP-MEM.git\x1b[0m");
+console.error("  Install Python 3.10+ and rerun this command.");
 console.error("");
 process.exit(1);

package/bin/install.mjs

@@ -1,36 +1,77 @@
 #!/usr/bin/env node
 
-import { execSync } from "child_process";
+import { spawnSync } from "child_process";
 import { fileURLToPath } from "url";
 import { dirname, resolve } from "path";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const root = resolve(__dirname, "..");
 
-function tryInstall(cmd) {
-  try {
-    execSync(cmd, { cwd: root, stdio: "pipe" });
-    return true;
-  } catch {
-    return false;
+function run(command, args, options = {}) {
+  return spawnSync(command, args, {
+    cwd: root,
+    stdio: options.stdio ?? "ignore",
+    env: {
+      ...process.env,
+      PIP_DISABLE_PIP_VERSION_CHECK: "1",
+    },
+  });
+}
+
+function pythonCandidates() {
+  if (process.env.KYP_MEM_PYTHON) {
+    return [[process.env.KYP_MEM_PYTHON, []]];
+  }
+
+  const candidates = [
+    ["python3", []],
+    ["python", []],
+  ];
+
+  if (process.platform === "win32") {
+    candidates.unshift(["py", ["-3"]]);
   }
+
+  return candidates;
+}
+
+function findPython() {
+  for (const [command, prefixArgs] of pythonCandidates()) {
+    const result = run(command, [...prefixArgs, "--version"]);
+    if (result.status === 0) {
+      return [command, prefixArgs];
+    }
+  }
+
+  return null;
 }
 
-// Check if already installed
-try {
-  execSync("kyp-mem --help", { stdio: "pipe" });
+if (process.env.KYP_MEM_SKIP_PYTHON_INSTALL === "1") {
   process.exit(0);
-} catch {}
+}
+
+const python = findPython();
+
+if (!python) {
+  console.log("  \x1b[33m!\x1b[0m Python 3 was not found.");
+  console.log("  \x1b[33m!\x1b[0m Install Python 3.10+ and run: python3 -m pip install --user .");
+  process.exit(0);
+}
+
+const [pythonCommand, pythonPrefixArgs] = python;
 
 console.log("  Installing kyp-mem Python package...");
 
-if (tryInstall("pip install --user .")) {
-  console.log("  \x1b[32m✓\x1b[0m kyp-mem installed successfully");
-} else if (tryInstall("pip3 install --user .")) {
-  console.log("  \x1b[32m✓\x1b[0m kyp-mem installed successfully");
-} else if (tryInstall("python3 -m pip install --user .")) {
+const result = run(
+  pythonCommand,
+  [...pythonPrefixArgs, "-m", "pip", "install", "--user", "."],
+  { stdio: "inherit" },
+);
+
+if (result.status === 0) {
   console.log("  \x1b[32m✓\x1b[0m kyp-mem installed successfully");
 } else {
-  console.log("  \x1b[33m!\x1b[0m Could not auto-install Python package.");
-  console.log("  \x1b[33m!\x1b[0m Run manually: pip install kyp-mem");
+  console.log("  \x1b[33m!\x1b[0m Could not auto-install the Python package.");
+  console.log(`  \x1b[33m!\x1b[0m Run manually from ${root}:`);
+  console.log("    python3 -m pip install --user .");
 }

package/kyp_mem/__init__.py

@@ -1,3 +1,3 @@
-"""KYP-MEM — Know Your Project Memory. Headless Obsidian for AI agents."""
+"""KYP-MEM — Know Your Project Memory. Headless knowledge base for AI agents."""
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"

package/kyp_mem/cli.py

@@ -16,7 +16,7 @@ R = "\033[0m"   # reset
 def main():
     parser = argparse.ArgumentParser(
         prog="kyp-mem",
-        description="KYP-MEM — Know Your Project Memory. Headless Obsidian for AI agents.",
+        description="KYP-MEM — Know Your Project Memory. Headless knowledge base for AI agents.",
     )
     parser.add_argument("--vault", default=None, help="Override vault path")
 
@@ -74,7 +74,7 @@ def _run_init():
     print(f"{C}  ██║  ██╗   ██║   ██║           ██║ ╚═╝ ██║███████╗██║ ╚═╝ ██║{R}")
     print(f"{C}  ╚═╝  ╚═╝   ╚═╝   ╚═╝           ╚═╝     ╚═╝╚══════╝╚═╝     ╚═╝{R}")
     print()
-    print(f"  {D}Know Your Project — Headless Obsidian for AI agents{R}")
+    print(f"  {D}Know Your Project — Headless knowledge base for AI agents{R}")
     print()
     print(f"  {Y}>> First-time setup{R}")
     print()
@@ -108,12 +108,20 @@ def _run_setup_claude(global_config: bool = False):
 
     vault_path = get_vault_path()
     kyp_mem_bin = shutil.which("kyp-mem")
-
-    if not kyp_mem_bin:
+    npx_bin = shutil.which("npx")
+
+    if kyp_mem_bin and "_npx" not in Path(kyp_mem_bin).parts:
+        mcp_command = kyp_mem_bin
+        mcp_args = ["serve"]
+    elif npx_bin:
+        mcp_command = npx_bin
+        mcp_args = ["-y", "kyp-mem", "serve"]
+    else:
         print(f"  {Y}Warning:{R} 'kyp-mem' not found in PATH.")
-        print(f"  {D}Make sure you installed with: pip install kyp-mem{R}")
+        print(f"  {D}Make sure you installed with: npm install -g kyp-mem{R}")
         print()
-        kyp_mem_bin = "kyp-mem"
+        mcp_command = "kyp-mem"
+        mcp_args = ["serve"]
 
     if global_config:
         settings_path = Path.home() / ".claude" / "settings.json"
@@ -134,8 +142,8 @@ def _run_setup_claude(global_config: bool = False):
     mcp_servers = settings.setdefault("mcpServers", {})
 
     mcp_servers["kyp-mem"] = {
-        "command": kyp_mem_bin,
-        "args": ["serve"],
+        "command": mcp_command,
+        "args": mcp_args,
         "env": {
             "KYP_VAULT": vault_path,
         },
@@ -148,7 +156,7 @@ def _run_setup_claude(global_config: bool = False):
     print()
     print(f"  {G}✓{R} MCP server added to {scope} settings")
     print(f"  {D}  File:    {settings_path}{R}")
-    print(f"  {D}  Command: {kyp_mem_bin} serve{R}")
+    print(f"  {D}  Command: {mcp_command} {' '.join(mcp_args)}{R}")
     print(f"  {D}  Vault:   {vault_path}{R}")
     print()
     print(f"  {C}Done!{R} Restart Claude Code and kyp-mem will run automatically.")
@@ -243,7 +251,7 @@ def _run_doctor():
 def _print_banner():
     print()
     print(f"{C}  KYP-MEM{R} — Know Your Project Memory")
-    print(f"  {D}Headless Obsidian for AI agents{R}")
+    print(f"  {D}Headless knowledge base for AI agents{R}")
     print()
 
 

package/kyp_mem/server.py

@@ -7,7 +7,7 @@ from .vault import Vault
 
 vault = Vault(get_vault_path())
 
-mcp = FastMCP("kyp-mem", description="Know Your Project — headless knowledge base like Obsidian")
+mcp = FastMCP("kyp-mem", description="Know Your Project — headless knowledge base for AI agents")
 
 
 @mcp.tool()

package/kyp_mem/ui.py

@@ -1,4 +1,4 @@
-"""KYP-MEM web UI — Obsidian-like interface for browsing the vault."""
+"""KYP-MEM web UI — interactive interface for browsing the vault."""
 
 import webbrowser
 from pathlib import Path

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "kyp-mem",
-  "version": "0.2.0",
-  "description": "Know Your Project — Headless Obsidian for AI agents. MCP-powered knowledge base with neon web UI.",
+  "version": "0.2.1",
+  "description": "Know Your Project — Headless knowledge base for AI agents. MCP-powered with wikilinks, backlinks, and neon web UI.",
   "bin": {
-    "kyp-mem": "./bin/cli.mjs"
+    "kyp-mem": "bin/cli.mjs"
   },
   "files": [
     "bin/",
-    "kyp_mem/",
+    "kyp_mem/*.py",
+    "kyp_mem/static/",
     "pyproject.toml",
     "README.md",
     "LICENSE"
@@ -17,7 +18,7 @@
   },
   "keywords": [
     "knowledge-base",
-    "obsidian",
+    "markdown",
     "ai",
     "mcp",
     "claude",
@@ -29,7 +30,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Adhithya-Karthikeyan/KYP-MEM.git"
+    "url": "git+https://github.com/Adhithya-Karthikeyan/KYP-MEM.git"
   },
   "homepage": "https://github.com/Adhithya-Karthikeyan/KYP-MEM"
 }

package/pyproject.toml

@@ -4,15 +4,15 @@ build-backend = "hatchling.build"
 
 [project]
 name = "kyp-mem"
-version = "0.2.0"
-description = "Know Your Project — Headless Obsidian for AI agents. MCP-powered knowledge base with neon web UI."
+version = "0.2.1"
+description = "Know Your Project — Headless knowledge base for AI agents. MCP-powered with wikilinks, backlinks, and neon web UI."
 readme = "README.md"
 license = {text = "MIT"}
 requires-python = ">=3.10"
 authors = [
-    {name = "KDB AI Agency", email = "dfreakhitman@gmail.com"}
+    {name = "KDB AI Agency", email = "skadhithya95@gmail.com"}
 ]
-keywords = ["knowledge-base", "obsidian", "ai", "mcp", "notes", "wiki", "second-brain"]
+keywords = ["knowledge-base", "markdown", "ai", "mcp", "notes", "wiki", "second-brain"]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",