@jz92/ai-provider 0.2.0

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@jz92/ai-provider",
+  "version": "0.2.0",
+  "description": "Environment-aware AI provider for portfolio projects. Local dev → Ollama, deployed → any cloud provider.",
+  "author": "Jithin Zachariah",
+  "license": "MIT",
+  "private": false,
+  "type": "module",
+
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "modelfiles-template",
+    "scripts",
+    "README.md"
+  ],
+
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "type-check": "tsc --noEmit",
+    "test": "NODE_ENV=development npx tsx --tsconfig tsconfig.test.json test/smoke.ts",
+    "postinstall": "node scripts/postinstall.js",
+    "setup:local": "bash scripts/setup-local.sh",
+    "prepublishOnly": "npm run build && npm run type-check"
+  },
+
+  "peerDependencies": {
+    "ai": ">=4.0.0",
+    "zod": ">=3.0.0",
+    "@ai-sdk/anthropic": ">=1.0.0",
+    "@ai-sdk/openai": ">=1.0.0",
+    "@ai-sdk/google": ">=1.0.0",
+    "@ai-sdk/groq": ">=1.0.0",
+    "@ai-sdk/mistral": ">=1.0.0",
+    "ollama-ai-provider": ">=0.16.0"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/anthropic":  { "optional": true },
+    "@ai-sdk/openai":     { "optional": true },
+    "@ai-sdk/google":     { "optional": true },
+    "@ai-sdk/groq":       { "optional": true },
+    "@ai-sdk/mistral":    { "optional": true },
+    "ollama-ai-provider": { "optional": true }
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.0.0",
+    "@types/node": "^20.0.0",
+    "ai": "^4.0.0",
+    "zod": "^3.23.0",
+    "@ai-sdk/anthropic": "^1.0.0",
+    "@ai-sdk/openai": "^1.0.0",
+    "@ai-sdk/google": "^1.0.0",
+    "@ai-sdk/groq": "^1.0.0",
+    "@ai-sdk/mistral": "^1.0.0",
+    "ollama-ai-provider": "^0.16.0"
+  },
+
+  "engines": { "node": ">=18.0.0" },
+  "keywords": ["ai", "ollama", "anthropic", "openai", "google", "groq", "mistral", "vercel-ai-sdk", "llm", "provider"]
+}

package/scripts/postinstall.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+
+// Runs after npm install — prints a clear setup guide
+// so consumers know exactly which peer deps to install.
+
+const reset  = '\x1b[0m'
+const bold   = '\x1b[1m'
+const cyan   = '\x1b[36m'
+const yellow = '\x1b[33m'
+const green  = '\x1b[32m'
+const dim    = '\x1b[2m'
+
+console.log(`
+${bold}@jithin/ai-provider${reset} installed successfully.
+
+${yellow}Next: install the provider adapters you need.${reset}
+
+${bold}Local dev (Ollama — free, no API key):${reset}
+  ${cyan}npm install ollama-ai-provider${reset}
+  ${dim}Then: brew install ollama && ollama pull qwen2.5-coder:14b${reset}
+
+${bold}Cloud providers (install only what you use):${reset}
+  ${cyan}npm install @ai-sdk/anthropic${reset}   ${dim}→ ANTHROPIC_API_KEY   https://console.anthropic.com${reset}
+  ${cyan}npm install @ai-sdk/openai${reset}       ${dim}→ OPENAI_API_KEY      https://platform.openai.com/api-keys${reset}
+  ${cyan}npm install @ai-sdk/google${reset}       ${dim}→ GOOGLE_GENERATIVE_AI_API_KEY  https://aistudio.google.com${reset}
+  ${cyan}npm install @ai-sdk/groq${reset}         ${dim}→ GROQ_API_KEY        https://console.groq.com/keys${reset}
+  ${cyan}npm install @ai-sdk/mistral${reset}      ${dim}→ MISTRAL_API_KEY     https://console.mistral.ai${reset}
+
+${bold}Required in all cases:${reset}
+  ${cyan}npm install ai zod${reset}
+
+${bold}Set NODE_ENV in your .env:${reset}
+  ${dim}development${reset}  → Ollama (free, local)
+  ${dim}test${reset}         → cheapest cloud model  (CI)
+  ${dim}production${reset}   → best cloud model      (deployed)
+
+${green}Docs: https://github.com/jithinjohnzachariah92/ai-provider (npm: @jz92/ai-provider)${reset}
+`)

package/scripts/setup-local.sh

@@ -0,0 +1,73 @@
+#!/bin/bash
+set -e
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  @jithin/ai-provider — Local Setup"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+# ── Check Ollama ──────────────────────────────────────────────────────────────
+if ! command -v ollama &> /dev/null; then
+  echo "✗ Ollama not found."
+  echo "  Install: brew install ollama"
+  echo "  Or:      https://ollama.com/download"
+  exit 1
+fi
+echo "✓ Ollama installed"
+
+# ── Start Ollama if not already running ──────────────────────────────────────
+if ! curl -s http://localhost:11434 > /dev/null 2>&1; then
+  echo "→ Starting Ollama daemon..."
+  ollama serve > /dev/null 2>&1 &
+  sleep 3
+fi
+echo "✓ Ollama running at http://localhost:11434"
+
+# ── Pull base model ───────────────────────────────────────────────────────────
+echo ""
+echo "→ Pulling qwen2.5-coder:14b (skip if already present)..."
+ollama pull qwen2.5-coder:14b
+echo "✓ Base model ready"
+
+# ── Optional: pull embedding model for semantic cache ─────────────────────────
+echo ""
+echo "→ Pulling nomic-embed-text (used for semantic response cache)..."
+ollama pull nomic-embed-text
+echo "✓ Embedding model ready"
+
+# ── Build project-specific model variants ────────────────────────────────────
+# Looks for Modelfile.* in a ./modelfiles directory at the project root.
+# Projects copy modelfiles-template/Modelfile.template and customise it.
+MODELFILES_DIR="$(pwd)/modelfiles"
+
+if [ -d "$MODELFILES_DIR" ]; then
+  echo ""
+  echo "→ Building project model variants from ./modelfiles/..."
+  for f in "$MODELFILES_DIR"/Modelfile.*; do
+    name="${f##*.}"   # extracts the part after the last dot
+    echo "  ollama create $name"
+    ollama create "$name" -f "$f"
+  done
+  echo "✓ Project variants ready"
+else
+  echo ""
+  echo "ℹ  No ./modelfiles directory found — skipping project variants."
+  echo "   Copy modelfiles-template/Modelfile.template to get started."
+fi
+
+# ── Show installed models ─────────────────────────────────────────────────────
+echo ""
+echo "Installed models:"
+ollama list
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  Done. Local AI endpoint: http://localhost:11434"
+echo ""
+echo "  Next steps:"
+echo "  1. Copy .env.development.example → .env.development"
+echo "  2. Set OLLAMA_MODEL to your variant name"
+echo "  3. npm run dev"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""