@opperai/setup 0.1.0

package/README.md

@@ -0,0 +1,27 @@
+# @opperai/setup
+
+Interactive CLI to set up Opper tooling.
+
+```bash
+npx @opperai/setup
+```
+
+## What it installs
+
+**AI Code Editors**
+- **Skills** — Opper skills for your AI code editor
+- **OpenCode** — Configure Opper as an OpenCode provider with curated models
+
+**SDKs**
+- **Node SDK** — AI functions, RAG, and tracing for TypeScript (`opperai`)
+- **Node Agent SDK** — Build agents with tool use and reasoning (`@opperai/agents`)
+- **Python SDK** — AI functions, RAG, and tracing for Python (`opperai`)
+- **Python Agent SDK** — Build agents with tool use and reasoning (`opper-agents`)
+
+**Tools**
+- **Opper CLI** — Call functions, manage indexes, and track usage from the terminal
+
+## Requirements
+
+- Node.js 18+
+- An Opper API key from [platform.opper.ai](https://platform.opper.ai)

package/data/opencode.json

@@ -0,0 +1,116 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "opper": {
+      "npm": "@ai-sdk/openai-compatible",
+      "name": "Opper",
+      "options": {
+        "baseURL": "http://localhost:8000/v2/openai",
+        "apiKey": "{env:OPPER_API_KEY}"
+      },
+      "models": {
+        "anthropic/claude-sonnet-4.5": {
+          "name": "Claude Sonnet 4.5",
+          "cost": { "input": 3.00, "output": 15.00 },
+          "limit": { "context": 200000, "output": 64000 }
+        },
+        "anthropic/claude-opus-4.5": {
+          "name": "Claude Opus 4.5",
+          "cost": { "input": 5.00, "output": 25.00 },
+          "limit": { "context": 200000, "output": 64000 }
+        },
+        "aws/claude-sonnet-4.5-eu": {
+          "name": "Claude Sonnet 4.5 (EU)",
+          "cost": { "input": 3.00, "output": 15.00 },
+          "limit": { "context": 200000, "output": 64000 }
+        },
+        "aws/claude-opus-4.5-eu": {
+          "name": "Claude Opus 4.5 (EU)",
+          "cost": { "input": 5.00, "output": 25.00 },
+          "limit": { "context": 200000, "output": 64000 }
+        },
+        "openai/gpt-5.2": {
+          "name": "GPT 5.2",
+          "cost": { "input": 1.75, "output": 14.00 },
+          "limit": { "context": 400000, "output": 128000 }
+        },
+        "openai/gpt-5-mini": {
+          "name": "GPT 5 Mini",
+          "cost": { "input": 0.25, "output": 1.00 },
+          "limit": { "context": 400000, "output": 128000 }
+        },
+        "openai/gpt-5-nano": {
+          "name": "GPT 5 Nano",
+          "cost": { "input": 0.05, "output": 0.40 },
+          "limit": { "context": 400000, "output": 128000 }
+        },
+        "azure/gpt-5-mini": {
+          "name": "GPT 5 Mini (EU)",
+          "cost": { "input": 0.25, "output": 2.00 },
+          "limit": { "context": 400000, "output": 128000 }
+        },
+        "azure/gpt-5-nano": {
+          "name": "GPT 5 Nano (EU)",
+          "cost": { "input": 0.05, "output": 0.40 },
+          "limit": { "context": 400000, "output": 128000 }
+        },
+        "gcp/gemini-2.5-pro": {
+          "name": "Gemini 2.5 Pro",
+          "cost": { "input": 1.25, "output": 10.00 },
+          "limit": { "context": 1000000, "output": 65536 }
+        },
+        "gcp/gemini-2.5-pro-eu": {
+          "name": "Gemini 2.5 Pro (EU)",
+          "cost": { "input": 1.25, "output": 10.00 },
+          "limit": { "context": 1000000, "output": 65536 }
+        },
+        "gcp/gemini-2.5-flash": {
+          "name": "Gemini 2.5 Flash",
+          "cost": { "input": 0.30, "output": 2.50 },
+          "limit": { "context": 1000000, "output": 65536 }
+        },
+        "gcp/gemini-2.5-flash-eu": {
+          "name": "Gemini 2.5 Flash (EU)",
+          "cost": { "input": 0.30, "output": 2.50 },
+          "limit": { "context": 1000000, "output": 65536 }
+        },
+        "gcp/gemini-2.5-flash-lite": {
+          "name": "Gemini 2.5 Flash Lite",
+          "cost": { "input": 0.10, "output": 0.40 },
+          "limit": { "context": 1000000, "output": 65536 }
+        },
+        "gcp/gemini-2.5-flash-lite-eu": {
+          "name": "Gemini 2.5 Flash Lite (EU)",
+          "cost": { "input": 0.10, "output": 0.40 },
+          "limit": { "context": 1000000, "output": 65536 }
+        },
+        "gcp/gemini-3-flash-preview": {
+          "name": "Gemini 3 Flash Preview",
+          "cost": { "input": 0.50, "output": 3.00 },
+          "limit": { "context": 1000000, "output": 65536 }
+        },
+        "fireworks/kimi-k2.5": {
+          "name": "Kimi K2.5",
+          "cost": { "input": 0.60, "output": 3.00 },
+          "limit": { "context": 256000, "output": 65536 }
+        },
+        "fireworks/glm-4.7": {
+          "name": "GLM 4.7",
+          "cost": { "input": 0.60, "output": 2.20 },
+          "limit": { "context": 200000, "output": 128000 }
+        },
+        "groq/gpt-oss-120b": {
+          "name": "GPT OSS 120B",
+          "cost": { "input": 0.15, "output": 0.75 },
+          "limit": { "context": 131072, "output": 131072 }
+        },
+        "aws/gpt-oss-120b-eu": {
+          "name": "GPT OSS 120B (EU)",
+          "cost": { "input": 0.15, "output": 0.60 },
+          "limit": { "context": 128000, "output": 8192 }
+        }
+      }
+    }
+  },
+  "model": "opper/gcp/gemini-2.5-flash-eu"
+}

package/dist/apikey.d.ts

@@ -0,0 +1 @@
+export declare function setupApiKey(): Promise<void>;

package/dist/apikey.js

@@ -0,0 +1,46 @@
+import { confirm, input } from "@inquirer/prompts";
+import { exec } from "node:child_process";
+function openBrowser(url) {
+    const cmd = process.platform === "darwin"
+        ? `open "${url}"`
+        : process.platform === "win32"
+            ? `start "${url}"`
+            : `xdg-open "${url}"`;
+    exec(cmd);
+}
+export async function setupApiKey() {
+    if (process.env.OPPER_API_KEY) {
+        console.log("OPPER_API_KEY is set.\n");
+        return;
+    }
+    console.log("OPPER_API_KEY is not set.\n");
+    const wantsKey = await confirm({
+        message: "Would you like to set up your Opper API key now?",
+        default: true,
+    });
+    if (!wantsKey) {
+        console.log();
+        return;
+    }
+    const openSite = await confirm({
+        message: "Open https://platform.opper.ai to get your API key?",
+        default: true,
+    });
+    if (openSite) {
+        openBrowser("https://platform.opper.ai");
+        console.log("\nOpening browser...\n");
+    }
+    const key = await input({
+        message: "Paste your API key:",
+        validate: (value) => (value.trim().length > 0 ? true : "API key cannot be empty"),
+    });
+    const shell = process.env.SHELL || "";
+    const rcFile = shell.includes("zsh")
+        ? "~/.zshrc"
+        : shell.includes("bash")
+            ? "~/.bashrc"
+            : "your shell profile";
+    console.log(`\nAdd this to ${rcFile}:\n`);
+    console.log(`  export OPPER_API_KEY=${key.trim()}\n`);
+    console.log(`Then run: source ${rcFile}\n`);
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import { checkbox, Separator } from "@inquirer/prompts";
+import { setupOpenCode } from "./opencode.js";
+import { setupSkills } from "./skills.js";
+import { setupApiKey } from "./apikey.js";
+import { installPackage, installCli } from "./install.js";
+async function main() {
+    console.log();
+    await setupApiKey();
+    const selections = await checkbox({
+        message: "What would you like to set up? (space to select/deselect, enter to confirm)",
+        choices: [
+            new Separator(" "),
+            new Separator("── AI Code Editors ──"),
+            {
+                name: "Skills — Add Opper skills to your AI code editor",
+                value: "skills",
+                checked: true,
+            },
+            {
+                name: "OpenCode — Use Opper models in OpenCode",
+                value: "opencode",
+            },
+            new Separator(" "),
+            new Separator("── SDKs ──"),
+            {
+                name: "Node SDK — AI functions, RAG, and tracing for TypeScript (opperai)",
+                value: "node-sdk",
+            },
+            {
+                name: "Node Agent SDK — Build agents with tool use and reasoning (@opperai/agents)",
+                value: "node-agents",
+            },
+            {
+                name: "Python SDK — AI functions, RAG, and tracing for Python (opperai)",
+                value: "python-sdk",
+            },
+            {
+                name: "Python Agent SDK — Build agents with tool use and reasoning (opper-agents)",
+                value: "python-agents",
+            },
+            new Separator(" "),
+            new Separator("── Tools ──"),
+            {
+                name: "Opper CLI — Call functions, manage indexes, and track usage from the terminal",
+                value: "cli",
+            },
+        ],
+    });
+    if (selections.length === 0) {
+        console.log("Nothing selected. Exiting.");
+        return;
+    }
+    if (selections.includes("skills")) {
+        await setupSkills();
+    }
+    if (selections.includes("opencode")) {
+        await setupOpenCode();
+    }
+    if (selections.includes("node-sdk")) {
+        await installPackage("npm", "opperai", "Opper Node SDK");
+    }
+    if (selections.includes("node-agents")) {
+        await installPackage("npm", "@opperai/agents", "Opper Node Agent SDK");
+    }
+    if (selections.includes("python-sdk")) {
+        await installPackage("pip", "opperai", "Opper Python SDK");
+    }
+    if (selections.includes("python-agents")) {
+        await installPackage("pip", "opper-agents", "Opper Python Agent SDK");
+    }
+    if (selections.includes("cli")) {
+        await installCli();
+    }
+    console.log("\nDone!");
+}
+main().catch((error) => {
+    if (error instanceof Error && error.name === "ExitPromptError") {
+        console.log("\nSetup cancelled.");
+        process.exit(0);
+    }
+    console.error("\nSetup failed:", error instanceof Error ? error.message : error);
+    process.exit(1);
+});

package/dist/install.d.ts

@@ -0,0 +1,2 @@
+export declare function installPackage(manager: "npm" | "pip", pkg: string, label: string): Promise<void>;
+export declare function installCli(): Promise<void>;

package/dist/install.js

@@ -0,0 +1,22 @@
+import { execSync } from "node:child_process";
+export async function installPackage(manager, pkg, label) {
+    console.log(`\n--- ${label} ---\n`);
+    const cmd = manager === "npm" ? `npm install ${pkg}` : `pip install ${pkg}`;
+    console.log(`Running: ${cmd}\n`);
+    execSync(cmd, { stdio: "inherit" });
+    console.log(`\n${label} installed.`);
+}
+export async function installCli() {
+    console.log("\n--- Opper CLI ---\n");
+    if (process.platform !== "darwin") {
+        console.log("The Opper CLI is currently available via Homebrew on macOS.");
+        console.log("For other platforms, download from:");
+        console.log("  https://github.com/opper-ai/oppercli/releases/latest\n");
+        return;
+    }
+    console.log("Installing via Homebrew...\n");
+    execSync("brew tap opper-ai/oppercli git@github.com:opper-ai/oppercli && brew install opper", {
+        stdio: "inherit",
+    });
+    console.log("\nOpper CLI installed. Run `opper config add default <your-api-key>` to configure.");
+}

package/dist/opencode.d.ts

@@ -0,0 +1 @@
+export declare function setupOpenCode(): Promise<void>;

package/dist/opencode.js

@@ -0,0 +1,48 @@
+import { readFileSync, mkdirSync, writeFileSync, existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+import { fileURLToPath } from "node:url";
+import { confirm } from "@inquirer/prompts";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+export async function setupOpenCode() {
+    console.log("\n--- OpenCode Setup ---\n");
+    // Read embedded config template
+    const templatePath = join(__dirname, "..", "data", "opencode.json");
+    const config = readFileSync(templatePath, "utf-8");
+    const configDir = join(homedir(), ".config", "opencode");
+    const configPath = join(configDir, "opencode.json");
+    // Check if config already exists with opper provider
+    if (existsSync(configPath)) {
+        try {
+            const existing = JSON.parse(readFileSync(configPath, "utf-8"));
+            if (existing?.provider?.opper) {
+                const overwrite = await confirm({
+                    message: "OpenCode config already has an Opper provider. Overwrite?",
+                    default: false,
+                });
+                if (!overwrite) {
+                    console.log("Skipping OpenCode setup.");
+                    return;
+                }
+            }
+        }
+        catch {
+            // If we can't parse the existing file, proceed with overwrite
+        }
+    }
+    // Write config
+    mkdirSync(configDir, { recursive: true });
+    writeFileSync(configPath, config, "utf-8");
+    console.log(`Wrote config to ${configPath}`);
+    // Check for API key
+    if (!process.env.OPPER_API_KEY) {
+        console.log("\n⚠ OPPER_API_KEY is not set. Add it to your shell profile:\n" +
+            "\n  export OPPER_API_KEY=<your-api-key>\n" +
+            "\nGet your API key at https://platform.opper.ai\n");
+    }
+    else {
+        console.log("OPPER_API_KEY is set.");
+    }
+    const parsed = JSON.parse(config);
+    console.log(`Default model: ${parsed.model}`);
+}

package/dist/skills.d.ts

@@ -0,0 +1 @@
+export declare function setupSkills(): Promise<void>;

package/dist/skills.js

@@ -0,0 +1,9 @@
+import { execSync } from "node:child_process";
+export async function setupSkills() {
+    console.log("\n--- Skills Setup ---\n");
+    console.log("Installing Opper skills for Claude Code...\n");
+    execSync("npx skills add opper-ai/opper-skills", {
+        stdio: "inherit",
+    });
+    console.log("\nSkills installed successfully.");
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@opperai/setup",
+  "version": "0.1.0",
+  "description": "Set up Opper tooling for AI code editors",
+  "type": "module",
+  "bin": {
+    "opper-setup": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "data"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.0",
+    "tsx": "^4",
+    "typescript": "^5"
+  }
+}