clarity-ai 6.4.1 → 6.5.1

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 ---
 
+## 6.5.0 (2026-06-06)
+
+### Closed Source + Space Proxy
+- All tokens removed from source code — zero hardcoded secrets
+- `LICENSE`: Proprietary, all rights reserved (`UNLICENSED`)
+- Provider now points to `Clarity-main` Space endpoint (`*.hf.space`) instead of `api-inference.huggingface.co` — fixes DNS resolution issues on Termux/Android
+- Clarity-main Space runs inference proxy: forwards to HF Inference API using internal `HF_TOKEN` secret
+- No API key required from CLI — works out of the box on any network
+- Space app: `space_app.py` — Gradio + FastAPI, `/v1/chat/completions` streaming, `/main-data` data endpoint
+
+## 6.4.2 (2026-06-06)
+
+### Keyless Clarity Flash
+- HuggingFace provider no longer requires API key
+- Built-in HF token for Clarity Flash model — works out of the box, no setup
+- Can still override with `HF_TOKEN` env var or `/keys huggingface <token>`
+
 ## 6.4.1 (2026-06-06)
 
 ### Clarity Flash 14B Model

package/LICENSE

@@ -0,0 +1,12 @@
+CLARITY AI — Proprietary Software
+
+Copyright (c) 2026 Universal-618
+
+All rights reserved.
+
+This software and its source code are proprietary and confidential.
+Unauthorized copying, modification, distribution, or use of this
+software, via any medium, is strictly prohibited without prior
+written permission from the copyright holder.
+
+This software is provided "as is", without warranty of any kind.

package/README.md

@@ -103,16 +103,10 @@ clarity /bash ls -la
 | Gemini 2.0 Flash | Google | 32K (fast) |
 | DeepSeek R1 Free | OpenRouter | 128K |
 
-## Provider Comparison
+## Architecture
 
-| Provider | Free Tier | Streaming | Priority |
-|---|---|---|---|
-| Groq | ✓ | ✓ | 1 (fastest) |
-| Google Gemini | ✓ | ✓ | 2 |
-| HuggingFace (Clarity Flash) | Needs HF_TOKEN | ✓ | 3 |
-| DeepSeek | Cheap | ✓ | 4 |
-| OpenRouter | ✓ | ✓ | 5 |
+Clarity Flash 14B is served via `Clarity-main` HF Space — a streaming inference proxy at `*.hf.space/v1/chat/completions`. No API keys needed.
 
 ## License
 
-MIT
+Proprietary — all rights reserved. See [LICENSE](LICENSE).

package/package.json

@@ -1,17 +1,23 @@
 {
   "name": "clarity-ai",
-  "version": "6.4.1",
-  "description": "Premium terminal AI agent — Clarity Flash 14B model, HF Inference API, fixed-height viewport, TrueColor theme",
+  "version": "6.5.1",
+  "description": "CLARITY — terminal AI agent with Clarity Flash 14B",
   "type": "module",
   "bin": {
     "clarity": "bin/clarity.js"
   },
   "scripts": {
-    "start": "node bin/clarity.js"
+    "start": "node bin/clarity.js",
+    "postinstall": "node scripts/postinstall.js"
   },
   "engines": {
     "node": ">=18.0.0"
   },
+  "license": "UNLICENSED",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
     "ink": "^5",
     "react": "^18",

package/requirements.txt

@@ -0,0 +1,3 @@
+fastapi>=0.100
+httpx>=0.27
+uvicorn>=0.20

package/scripts/postinstall.js

@@ -1,59 +1,36 @@
-import figlet from 'figlet';
-import gradient from 'gradient-string';
-import chalk from 'chalk';
-
-const GRADIENT = gradient(['#00d2ff', '#7b2ff7']);
-
-try {
-  const text = figlet.textSync('CLARITY', { font: 'ANSI Shadow' });
-  console.log(GRADIENT(text));
-} catch {
-  console.log(GRADIENT('CLARITY'));
-}
-
-const nodeVersion = process.versions.node;
-const [major] = nodeVersion.split('.').map(Number);
-const W = process.stdout.columns || 80;
-const line = '═'.repeat(W - 4);
+import { existsSync, chmodSync, writeFileSync, unlinkSync, lstatSync } from 'fs';
+import { resolve } from 'path';
 
+const nodeVer = process.versions.node;
+const [major] = nodeVer.split('.').map(Number);
 if (major < 18) {
-  console.error();
-  console.error(chalk.hex('#ff4466')(`  ╔${line}╗`));
-  console.error(chalk.hex('#ff4466')(`  ║  ✗ Node.js 18+ required. You have v${nodeVersion}`));
-  console.error(chalk.hex('#ffcc00')(`  ║  Termux: pkg install nodejs-lts`));
-  console.error(chalk.hex('#ff4466')(`  ╚${line}╝`));
-  console.error();
+  console.error('\n  \u2717 Node.js 18+ required. You have v' + nodeVer);
+  console.error('  Termux: pkg install nodejs-lts\n');
   process.exit(1);
 }
 
 const isTermux = process.env.PREFIX?.includes('com.termux');
+const W = process.stdout.columns || 80;
+const line = '\u2500'.repeat(Math.min(W - 4, 60));
 
-console.log();
-console.log(chalk.hex('#00ff88')(`  ╔${line}╗`));
-console.log(chalk.hex('#00ff88')(`  ║  ✓ CLARITY installed successfully!`));
-console.log(chalk.hex('#00d2ff')(`  ║  Run: clarity init`));
-console.log(chalk.hex('#00ff88')(`  ╚${line}╝`));
-console.log();
-console.log(chalk.hex('#666888')("  Run 'clarity init' to configure your AI keys and get started."));
+console.log(`\n  \u250C${line}\u2510`);
+console.log(`  \u2502  CLARITY installed`);
+console.log(`  \u2502  Run: clarity init`);
+console.log(`  \u2514${line}\u2518\n`);
 
 const binDir = process.env.npm_config_prefix ? `${process.env.npm_config_prefix}/bin` : null;
 if (isTermux && binDir) {
-  const { existsSync, writeFileSync, chmodSync, unlinkSync, lstatSync } = await import('fs');
-  const { resolve } = await import('path');
   const symlinkPath = resolve(binDir, 'clarity');
-
   try {
     if (existsSync(symlinkPath)) {
       const stat = lstatSync(symlinkPath);
-      if (stat.isSymbolicLink()) {
-        unlinkSync(symlinkPath);
-      }
+      if (stat.isSymbolicLink()) unlinkSync(symlinkPath);
     }
-    const clarityPkgDir = process.env.PREFIX ? `${process.env.PREFIX}/lib/node_modules/clarity-ai` : resolve(process.cwd());
-    writeFileSync(symlinkPath, `#!/data/data/com.termux/files/usr/bin/bash\nexec node "${clarityPkgDir}/bin/clarity.js" "$@"\n`);
+    const pkgDir = process.env.PREFIX
+      ? `${process.env.PREFIX}/lib/node_modules/clarity-ai`
+      : resolve(process.cwd());
+    writeFileSync(symlinkPath, `#!/data/data/com.termux/files/usr/bin/bash\nexec node "${pkgDir}/bin/clarity.js" "$@"\n`);
     chmodSync(symlinkPath, '755');
-    console.log(chalk.hex('#00ff88')('  ✓ Termux wrapper created at:'), chalk.hex('#00d2ff')(symlinkPath));
-  } catch (e) {
-    console.error(chalk.hex('#ff4466')('  ✗ Failed to create Termux wrapper:'), e.message);
-  }
+    console.log('  \u2713 Termux wrapper created');
+  } catch {}
 }

package/space_app.py

@@ -0,0 +1,45 @@
+import os, json, asyncio
+import httpx
+from fastapi import FastAPI, Request
+from fastapi.responses import StreamingResponse, JSONResponse
+from contextlib import asynccontextmanager
+
+HF_TOKEN = os.environ.get('HF_TOKEN', '')
+MODEL = os.environ.get('HF_MODEL', 'Universal-618/Clarity-flash-weights')
+API = f'https://api-inference.huggingface.co/models/{MODEL}/v1/chat/completions'
+HEADERS = {'Authorization': f'Bearer {HF_TOKEN}', 'Content-Type': 'application/json'}
+
+app = FastAPI()
+
+@app.post('/v1/chat/completions')
+async def proxy(request: Request):
+    body = await request.json()
+    body['model'] = MODEL
+    stream = body.get('stream', True)
+    body['stream'] = stream
+    async with httpx.AsyncClient(timeout=120) as client:
+        resp = await client.post(API, headers=HEADERS, json=body)
+        if resp.status_code != 200:
+            return JSONResponse({'error': await resp.aread()}, status_code=resp.status_code)
+        if stream:
+            return StreamingResponse(resp.aiter_lines(), media_type='text/event-stream', headers={
+                'Cache-Control': 'no-cache', 'Connection': 'keep-alive', 'X-Accel-Buffering': 'no'
+            })
+        return resp.json()
+
+@app.get('/main-data/{path:path}')
+async def main_data(path: str):
+    path = path or 'index.json'
+    fp = f'/data/{path}'
+    if not os.path.exists(fp):
+        return JSONResponse({'error': 'not found'}, status_code=404)
+    with open(fp) as f:
+        return JSONResponse(json.load(f))
+
+@app.get('/')
+async def root():
+    return {'status': 'ok', 'model': MODEL, 'docs': '/v1/chat/completions'}
+
+if __name__ == '__main__':
+    import uvicorn
+    uvicorn.run(app, host='0.0.0.0', port=7860)

package/src/config/keys.js

@@ -23,10 +23,10 @@ export function setKey(provider, key) {
 export function getKey(provider) {
   try {
     const keys = JSON.parse(readFileSync(KEYS_PATH, 'utf-8'));
-    return keys[provider] || process.env[provider.toUpperCase() + '_API_KEY'] || process.env.HF_TOKEN || null;
-  } catch {
-    return process.env[provider.toUpperCase() + '_API_KEY'] || process.env.HF_TOKEN || null;
-  }
+    if (keys[provider]) return keys[provider];
+  } catch {}
+  const envKey = process.env[provider.toUpperCase() + '_API_KEY'] || process.env.HF_TOKEN;
+  return envKey || null;
 }
 
 export function hasKey(provider) {

package/src/providers/index.js

@@ -2,17 +2,26 @@ import { getKey } from '../config/keys.js';
 import { streamResponse } from './streaming.js';
 import { parseErrorResponse } from './errors.js';
 
+const SPACES = [
+  'https://universal-618-clarity-main.hf.space',
+  'https://universal-618-clarity-2.hf.space',
+  'https://universal-618-clarity-3.hf.space',
+  'https://universal-618-clarity-4.hf.space',
+  'https://universal-618-clarity-5.hf.space',
+  'https://universal-618-clarity-6.hf.space',
+];
+
 const PROVIDERS = {
   huggingface: {
-    endpoint: 'https://api-inference.huggingface.co/models',
+    endpoints: SPACES.map(s => s + '/v1/chat/completions'),
     name: 'huggingface',
   },
   groq: {
-    endpoint: 'https://api.groq.com/openai/v1/chat/completions',
+    endpoints: ['https://api.groq.com/openai/v1/chat/completions'],
     name: 'groq',
   },
   openrouter: {
-    endpoint: 'https://openrouter.ai/api/v1/chat/completions',
+    endpoints: ['https://openrouter.ai/api/v1/chat/completions'],
     name: 'openrouter',
   },
 };
@@ -40,20 +49,26 @@ export async function* callAI(providerName, model, messages, options = {}) {
     body.tool_choice = 'auto';
   }
 
-  let endpoint = provider.endpoint;
   const extraHeaders = {};
-  if (providerName === 'huggingface') {
-    endpoint = provider.endpoint + '/' + modelName + '/v1/chat/completions';
-    if (key) extraHeaders['Authorization'] = 'Bearer ' + key;
-  } else if (providerName === 'openrouter') {
+  if (providerName === 'openrouter') {
     extraHeaders['HTTP-Referer'] = 'https://clarity-ai.local';
     extraHeaders['X-Title'] = 'CLARITY AI';
   }
 
-  const stream = streamResponse(endpoint, body, key || 'none', extraHeaders, options.signal);
-  for await (const event of stream) {
-    yield event;
+  let lastErr;
+  for (const endpoint of provider.endpoints) {
+    try {
+      const stream = streamResponse(endpoint, body, key || 'none', extraHeaders, options.signal);
+      for await (const event of stream) {
+        yield event;
+      }
+      return;
+    } catch (err) {
+      lastErr = err;
+      continue;
+    }
   }
+  throw lastErr;
 }
 
 export async function callAISync(providerName, model, messages, options = {}) {