claudmax 1.0.16 → 2.0.0

package/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "WebFetch(domain:claudmax.pro)"
+    ]
+  }
+}

package/.env.example

@@ -0,0 +1,24 @@
+# Environment Variables for ClaudeMax
+
+# NextAuth
+NEXTAUTH_URL=https://your-domain.com
+NEXTAUTH_SECRET=generate-with-openssl-rand-base64-32
+
+# Database (use Turso SQLite or Neon Postgres)
+DATABASE_URL="libsql://your-db.turso.io?authToken=your-token"
+# For local dev: DATABASE_URL="file:./dev.db"
+
+# OpenRouter API Key (get from https://openrouter.ai/keys)
+OPENROUTER_API_KEY=sk-or-v1-your-openrouter-api-key
+
+# LiteRouter API Key — primary backend (get from https://literouter.com)
+# Unlimited free requests/day on 5 free models (gemini-free, gpt-free, deepseek-free, glm-free, kimi-k2-thinking-free)
+# Note: 7.5s cooldown between requests, 1 concurrent request per key
+LITEROUTER_API_KEY=your-literouter-api-key
+
+# OpenRouter Site URL & Referer
+OPENROUTER_SITE_URL=https://your-domain.com
+OPENROUTER_SITE_NAME=ClaudMax
+
+# App Base URL
+NEXT_PUBLIC_APP_URL=https://your-domain.com

package/.github/workflows/publish.yml

@@ -0,0 +1,31 @@
+name: Publish npm Package
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'packages/cli/**'
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Publish CLI package
+        working-directory: packages/cli
+        run: |
+          npm ci
+          npm publish --access public --provenance
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/README.md

@@ -0,0 +1,178 @@
+# ClaudeMax
+
+> OpenAI-compatible API proxy powered by OpenRouter. Use Claude Code models in any IDE.
+
+## Features
+
+- **OpenAI-Compatible API** — Drop-in replacement for OpenAI API endpoints
+- **Claude Models** — Access Claude 3.5 Haiku, Sonnet, and Opus via OpenRouter
+- **API Key Management** — Generate, revoke, and track API keys from your dashboard
+- **Usage Analytics** — Real-time request tracking, token counts, and latency metrics
+- **Rate Limiting** — Per-user, per-tier rate limits out of the box
+- **Multi-Provider** — Claude, GPT-4o, Gemini Pro, DeepSeek, and 50+ models
+- **Self-Hosted** — Deploy on Vercel, Railway, Render, or any Node.js platform
+
+## Tech Stack
+
+- **Framework:** Next.js 14 (App Router)
+- **Styling:** Tailwind CSS + shadcn/ui
+- **Database:** SQLite (dev) / Turso (prod)
+- **ORM:** Prisma
+- **Auth:** NextAuth.js v4
+- **Proxy:** OpenRouter API
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js 18+
+- npm or pnpm
+- OpenRouter API key ([get one here](https://openrouter.ai/keys))
+
+### Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/claudemax.git
+cd claudemax
+
+# Install dependencies
+npm install
+
+# Set up environment variables
+cp .env.example .env.local
+# Edit .env.local with your values
+
+# Initialize database
+npm run db:push
+npm run db:generate
+
+# Start development server
+npm run dev
+```
+
+Visit [http://localhost:3000](http://localhost:3000)
+
+### Environment Variables
+
+| Variable | Description |
+|---|---|
+| `NEXTAUTH_URL` | Your app URL (e.g. http://localhost:3000) |
+| `NEXTAUTH_SECRET` | Random secret for NextAuth (generate with `openssl rand -base64 32`) |
+| `DATABASE_URL` | SQLite: `file:./dev.db` / Turso: `libsql://your-db.turso.io?authToken=...` |
+| `OPENROUTER_API_KEY` | Your OpenRouter API key |
+| `OPENROUTER_SITE_URL` | Your site URL for OpenRouter referer |
+| `OPENROUTER_SITE_NAME` | Your site name |
+
+## Usage
+
+### 1. Register & Get API Key
+
+Sign up at `/register`, then go to Dashboard → API Keys → Create Key.
+
+### 2. Use in Your App
+
+```bash
+# cURL
+curl -X POST https://api.yourdomain.com/v1/chat/completions \
+  -H "Authorization: Bearer cmx_your_api_key" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "anthropic/claude-3.5-sonnet",
+    "messages": [{"role": "user", "content": "Hello!"}]
+  }'
+```
+
+```python
+# Python
+from openai import OpenAI
+
+client = OpenAI(
+    base_url="https://api.yourdomain.com/v1",
+    api_key="cmx_your_api_key",
+)
+
+chat = client.chat.completions.create(
+    model="anthropic/claude-3.5-sonnet",
+    messages=[{"role": "user", "content": "Hello!"}],
+)
+```
+
+### 3. Works with Popular Tools
+
+- **Cursor** — Settings → Models → Add API Key → Set base URL
+- **Cline** — Settings → API Configuration → Custom provider
+- **OpenClaw** — Settings → API Provider → OpenAI compatible
+- **Continue.dev** — Config → Add model with custom base URL
+- **Aider** — `aider --openai-api-base https://api.yourdomain.com/v1 --openai-api-key cmx_...`
+
+## Pricing Tiers
+
+| Tier | Price | Requests/Day | Tokens/Month |
+|---|---|---|---|
+| Free | $0 | 100 | 100K |
+| Starter | $9/mo | 1,000 | 500K |
+| Pro | $29/mo | 5,000 | 2M |
+| Max | $79/mo | 20,000 | 10M |
+
+## Deployment
+
+### Vercel (Recommended)
+
+```bash
+npm i -g vercel
+vercel
+```
+
+Set environment variables in Vercel dashboard. Use **Turso** or **Neon** for the database.
+
+### Railway
+
+```bash
+railway init
+railway up
+```
+
+### Docker
+
+```dockerfile
+FROM node:18-alpine
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npx prisma generate
+RUN npx prisma db push
+EXPOSE 3000
+CMD ["npm", "start"]
+```
+
+## Project Structure
+
+```
+src/
+├── app/
+│   ├── api/
+│   │   ├── auth/          # NextAuth endpoints
+│   │   ├── v1/
+│   │   │   ├── chat/      # Proxy endpoint (core)
+│   │   │   ├── models/    # Available models list
+│   │   │   └── route.ts   # Health check
+│   │   ├── keys/          # API key CRUD
+│   │   └── usage/         # Usage logs
+│   ├── dashboard/         # Protected dashboard pages
+│   ├── login/             # Auth pages
+│   └── page.tsx           # Landing page
+├── components/
+│   ├── landing/           # Landing page sections
+│   └── ui/                # shadcn-style components
+└── lib/
+    ├── auth.ts             # NextAuth config
+    ├── prisma.ts           # Prisma client
+    ├── rate-limiter.ts     # In-memory rate limiting
+    └── utils.ts            # Helpers, pricing, constants
+```
+
+## License
+
+MIT

package/next-env.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+import "./.next/types/routes.d.ts";
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/next.config.mjs

@@ -0,0 +1,43 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  images: {
+    remotePatterns: [
+      { protocol: 'https', hostname: 'avatars.githubusercontent.com' },
+      { protocol: 'https', hostname: 'lh3.googleusercontent.com' },
+    ],
+  },
+  serverExternalPackages: ['@prisma/client', 'bcryptjs'],
+  async headers() {
+    return [
+      {
+        source: '/api/:path*',
+        headers: [
+          { key: 'X-Content-Type-Options', value: 'nosniff' },
+          { key: 'X-Frame-Options', value: 'DENY' },
+          { key: 'X-XSS-Protection', value: '1; mode=block' },
+          { key: 'Content-Security-Policy', value: "default-src 'none'; frame-ancestors 'none';" },
+          { key: 'Server', value: 'Claude-API' },
+          { key: 'X-Powered-By', value: '' },
+        ],
+      },
+    ];
+  },
+  async rewrites() {
+    return [
+      // For api.claudmax.pro — rewrite / to /api/v1 (returns JSON 404)
+      {
+        source: '/',
+        has: [{ type: 'host', value: '^(www\\.)?api\\.claudmax\\.pro$' }],
+        destination: '/api/v1',
+      },
+      // For api.claudmax.pro — rewrite /v1/* to /api/v1/*
+      {
+        source: '/v1/:path*',
+        has: [{ type: 'host', value: '^(www\\.)?api\\.claudmax\\.pro$' }],
+        destination: '/api/v1/:path*',
+      },
+    ];
+  },
+};
+
+export default nextConfig;

package/package.json

@@ -1,33 +1,61 @@
 {
   "name": "claudmax",
-  "version": "1.0.16",
-  "description": "ClaudMax CLI — Configure Claude Code, Cursor, Windsurf, Cline, and Roo Code to use ClaudMax API gateway with one command",
-  "main": "index.js",
-  "bin": {
-    "claudmax": "./index.js"
-  },
+  "version": "2.0.0",
   "scripts": {
-    "start": "node ./index.js"
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint",
+    "db:push": "prisma db push",
+    "db:generate": "prisma generate",
+    "db:studio": "prisma studio",
+    "db:seed": "tsx prisma/seed.ts",
+    "postinstall": "prisma generate"
   },
-  "keywords": [
-    "claudmax",
-    "claude",
-    "claude-code",
-    "anthropic",
-    "ai",
-    "api",
-    "proxy",
-    "gateway",
-    "cursor",
-    "windsurf",
-    "cline",
-    "mcp",
-    "setup",
-    "openrouter"
-  ],
-  "license": "MIT",
-  "engines": {
-    "node": ">=16.0.0"
+  "dependencies": {
+    "@auth/prisma-adapter": "^2.7.2",
+    "@libsql/client": "^0.17.2",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@prisma/adapter-libsql": "^7.7.0",
+    "@prisma/client": "^6.19.3",
+    "@radix-ui/react-dialog": "^1.1.2",
+    "@radix-ui/react-dropdown-menu": "^2.1.2",
+    "@radix-ui/react-label": "^2.1.0",
+    "@radix-ui/react-progress": "^1.1.0",
+    "@radix-ui/react-slot": "^1.1.0",
+    "@radix-ui/react-switch": "^1.1.1",
+    "@radix-ui/react-tabs": "^1.1.1",
+    "@radix-ui/react-toast": "^1.2.2",
+    "bcryptjs": "^2.4.3",
+    "class-variance-authority": "^0.7.0",
+    "clsx": "^2.1.1",
+    "jsonwebtoken": "^9.0.3",
+    "lucide-react": "^0.460.0",
+    "next": "^16.2.2",
+    "next-auth": "^4.24.10",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "resend": "^6.10.0",
+    "tailwind-merge": "^2.5.4",
+    "tailwindcss-animate": "^1.0.7",
+    "tsx": "^4.21.0",
+    "uuid": "^11.0.3",
+    "zod": "^3.23.8"
   },
-  "preferGlobal": true
+  "devDependencies": {
+    "@types/bcryptjs": "^2.4.6",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/jsonwebtoken": "^9.0.10",
+    "@types/node": "^22.9.0",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "@types/uuid": "^10.0.0",
+    "autoprefixer": "^10.4.20",
+    "eslint": "^8.57.1",
+    "eslint-config-next": "14.2.18",
+    "postcss": "^8.4.47",
+    "prisma": "^6.19.3",
+    "tailwindcss": "^3.4.14",
+    "typescript": "^5.6.3"
+  }
 }

package/{bin → packages/cli/bin}/claudmax.js

@@ -94,6 +94,8 @@ async function cmdConfigure() {
   printBanner();
   console.log(`${BOLD}Configure your ClaudMax API key${RESET}`);
   console.log('');
+  console.log(`${CYAN}Get Your API Key: https://www.claudmax.pro/support${RESET}`);
+  console.log('');
 
   const config = getConfig();
   if (config?.apiKey) {

package/{index.js → packages/cli/index.js}

@@ -80,7 +80,7 @@ function verifyConnection(apiKey) {
       method: 'POST',
       headers: {
         'Content-Type': 'application/json',
-        'User-Agent': 'ClaudMax-CLI/1.0.15',
+        'User-Agent': 'ClaudMax-CLI/2.0.0',
       },
       timeout: 15000,
     };

package/packages/cli/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "claudmax",
+  "version": "2.0.0",
+  "description": "ClaudMax CLI — Configure Claude Code, Cursor, Windsurf, Cline, and Roo Code to use ClaudMax API gateway with one command",
+  "main": "index.js",
+  "bin": {
+    "claudmax": "./index.js"
+  },
+  "scripts": {
+    "start": "node ./index.js"
+  },
+  "keywords": [
+    "claudmax",
+    "claude",
+    "claude-code",
+    "anthropic",
+    "ai",
+    "api",
+    "proxy",
+    "gateway",
+    "cursor",
+    "windsurf",
+    "cline",
+    "mcp",
+    "setup",
+    "openrouter"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "preferGlobal": true
+}

package/packages/mcp/index.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+
+/**
+ * ClaudMax MCP Server
+ * Exposes Claude AI tools via the Model Context Protocol.
+ */
+
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+
+// ── Config ──────────────────────────────────────────────────────────────────
+const API_KEY = process.env.CLAUDMAX_API_KEY || process.env.ANTHROPIC_API_KEY;
+const API_BASE = (process.env.CLAUDMAX_URL || process.env.ANTHROPIC_BASE_URL || 'https://api.claudmax.pro').replace(/\/+$/, '');
+const TIMEOUT_MS = 30000;
+
+// ── Helpers ──────────────────────────────────────────────────────────────────
+async function apiCall(path, body, timeout = TIMEOUT_MS) {
+  if (!API_KEY) {
+    throw new Error('CLAUDMAX_API_KEY or ANTHROPIC_API_KEY is not set');
+  }
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeout);
+  try {
+    const res = await fetch(`${API_BASE}${path}`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'x-api-key': API_KEY,
+      },
+      body: JSON.stringify(body),
+      signal: controller.signal,
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ error: { message: `HTTP ${res.status}` } }));
+      throw new Error(err.error?.message || err.error || `API error: ${res.status}`);
+    }
+    return await res.json();
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+// ── MCP Server ───────────────────────────────────────────────────────────────
+const server = new McpServer(
+  { name: 'ClaudMax', version: '2.0.0' },
+  { capabilities: { tools: {} } }
+);
+
+// ── Tools ─────────────────────────────────────────────────────────────────────
+
+// web_search
+server.registerTool('web_search', {
+  title: 'Web Search',
+  description: 'Search the web using ClaudMax API. Great for looking up current information, facts, news, and research.',
+  inputSchema: z.object({
+    query: z.string().describe('The search query'),
+    model: z.string().optional().describe('Model to use (optional)'),
+  }),
+}, async ({ query, model }) => {
+  try {
+    const result = await apiCall('/api/tools/web_search', { query, model });
+    const items = result.results || result.organic || [];
+    const text = items.map((r) => `## ${r.title}\n${r.snippet || r.summary || ''}\n${r.link || r.url || ''}`).join('\n\n');
+    return { content: [{ type: 'text', text: text || 'No results.' }] };
+  } catch (err) {
+    return { content: [{ type: 'text', text: `Search failed: ${err.message}` }], isError: true };
+  }
+});
+
+// understand_image
+server.registerTool('understand_image', {
+  title: 'Understand Image',
+  description: 'Analyze an image to understand its contents, describe objects, text, charts, or any visual information.',
+  inputSchema: z.object({
+    image_url: z.string().describe('URL or base64 data URL of the image'),
+    prompt: z.string().optional().describe('Question about the image'),
+  }),
+}, async ({ image_url, prompt }) => {
+  try {
+    const result = await apiCall('/api/tools/understand_image', {
+      image_url,
+      prompt: prompt || 'Describe this image.',
+    });
+    return { content: [{ type: 'text', text: result.description || result.content || 'Unable to analyze.' }] };
+  } catch (err) {
+    return { content: [{ type: 'text', text: `Image analysis failed: ${err.message}` }], isError: true };
+  }
+});
+
+// upload_file
+server.registerTool('upload_file', {
+  title: 'Upload File',
+  description: 'Upload and process files. Images are analyzed, text files are read. Supports PNG, JPEG, GIF, WebP, SVG, PDF, TXT, MD, JSON, CSV.',
+  inputSchema: z.object({
+    name: z.string().describe('Filename with extension (e.g. photo.png)'),
+    mime_type: z.string().describe('MIME type (e.g. image/png)'),
+    data: z.string().describe('Base64-encoded file contents'),
+    prompt: z.string().optional().describe('What to do with the file'),
+  }),
+}, async ({ name, mime_type, data, prompt }) => {
+  try {
+    const result = await apiCall('/api/tools/upload', {
+      files: [{ name, mime_type, data }],
+      prompt: prompt || 'Process this file.',
+    });
+    const files = result.files || [];
+    const outputs = files.map((f) => {
+      if (f.error) return `ERROR ${f.name}: ${f.error}`;
+      if (f.type === 'image') return `IMAGE ${f.name}: ${f.description || f.content}`;
+      if (f.type === 'text') return `TEXT ${f.name}:\n${f.content}`;
+      return `FILE ${f.name}: processed`;
+    });
+    return { content: [{ type: 'text', text: outputs.join('\n') }] };
+  } catch (err) {
+    return { content: [{ type: 'text', text: `Upload failed: ${err.message}` }], isError: true };
+  }
+});
+
+// ── Start ─────────────────────────────────────────────────────────────────────
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch((err) => {
+  console.error('ClaudMax MCP error:', err.message);
+  process.exit(1);
+});