krasavacode 0.1.0

package/README.md

@@ -0,0 +1,64 @@
+# KRASAVACODE
+
+Однокнопочный бесплатный вайбкодинг на Claude Code — для учеников.
+
+## Установка и запуск
+
+**Один способ:**
+
+```bash
+npx krasavacode
+```
+
+Всё. Pollinations работает без логина и без карты, лимитов хватит на 2–5 учебных MVP.
+
+При первой команде ставится локальный gateway и Claude Code (один раз, ~30 сек). Потом запуск моментальный.
+
+## Если хочешь больше моделей
+
+```bash
+npx krasavacode upgrade
+```
+
+Откроется дашборд в браузере. Там одним кликом подключишь:
+- **Kiro AI** — Claude Sonnet/Haiku через AWS Builder ID
+- **Qoder** — Kimi K2 / Qwen3-Coder / DeepSeek-R1
+- **Qwen Code** — 4 модели Alibaba
+- **LongCat** — 50M токенов в день
+
+Всё бесплатно, без карты.
+
+## Если что-то не работает
+
+```bash
+npx krasavacode doctor
+```
+
+Покажет, что сломано. Самые частые проблемы:
+- **Старый Node.js** → обнови до 20+ с https://nodejs.org
+- **Порт занят** → перезапусти терминал
+- **Корпоративный прокси/Россия/Китай** → запусти upgrade и в дашборде включи SOCKS5
+
+## Что под капотом
+
+```
+krasavacode  →  локальный OmniRoute  →  Pollinations / Kiro / Qoder / …
+                (free gateway, MIT)     (free providers без карты)
+```
+
+CLI = `@anthropic-ai/claude-code` с подменённым backend. Все обновления Claude Code от Anthropic прилетают автоматом.
+
+## Бинарники без Node.js
+
+Для уроков с непрофильными студентами — скачай готовый бинарник со страницы релиза:
+- `krasavacode.exe` (Windows)
+- `krasavacode-mac-arm64`, `krasavacode-mac-x64` (macOS)
+- `krasavacode-linux-x64` (Linux)
+
+Дабл-клик → откроется терминал с Claude Code. Node.js не нужен.
+
+> Замечание: бинарники тащат portable Node при первом запуске (~30 МБ, один раз). После — работают офлайн.
+
+## Лицензия
+
+MIT. Pollinations / Kiro AI / Qoder / другие провайдеры имеют свои ToS — читай их условия. На свой риск.

package/bin/krasavacode.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+import { ensureRuntime } from '../src/runtime.js';
+import { startHub, stopHub } from '../src/hub.js';
+import { ensurePreset } from '../src/preset.js';
+import { launchClaude } from '../src/launch.js';
+import { runUpgrade } from '../src/upgrade.js';
+import { runDoctor } from '../src/doctor.js';
+
+const cmd = process.argv[2];
+
+async function main() {
+  if (cmd === 'doctor') return runDoctor();
+  if (cmd === 'upgrade') return runUpgrade();
+  if (cmd === '--version' || cmd === '-v') {
+    const { readFile } = await import('node:fs/promises');
+    const { fileURLToPath } = await import('node:url');
+    const { dirname, join } = await import('node:path');
+    const here = dirname(fileURLToPath(import.meta.url));
+    const pkg = JSON.parse(await readFile(join(here, '..', 'package.json'), 'utf8'));
+    console.log(`KRASAVACODE v${pkg.version}`);
+    return;
+  }
+
+  const paths = await ensureRuntime();
+  await ensurePreset();
+  const hub = await startHub(paths);
+
+  process.on('SIGINT', () => stopHub(hub).then(() => process.exit(0)));
+  process.on('SIGTERM', () => stopHub(hub).then(() => process.exit(0)));
+
+  await launchClaude(paths, hub);
+
+  await stopHub(hub);
+}
+
+main().catch(err => {
+  console.error('\n❌ KRASAVACODE упал:', err.message);
+  if (process.env.KRASAVACODE_DEBUG) console.error(err.stack);
+  console.error('\nЗапусти `krasavacode doctor` для диагностики.');
+  process.exit(1);
+});

package/config/krasavacode-combo.json

@@ -0,0 +1,13 @@
+{
+  "name": "Krasava-Free",
+  "description": "Дефолтный preset KRASAVACODE: бесплатные провайдеры без карты, в порядке предпочтения.",
+  "providers": [
+    { "id": "pollinations", "auth": "none", "models": ["openai-large", "claude", "deepseek"] },
+    { "id": "longcat", "auth": "none", "models": ["LongCat-Flash-Lite"] },
+    { "id": "kiro", "auth": "oauth-aws-builder-id", "models": ["claude-sonnet-4.5", "claude-haiku-4.5"] },
+    { "id": "qoder", "auth": "oauth-google", "models": ["kimi-k2-thinking", "qwen3-coder-plus", "deepseek-r1"] },
+    { "id": "qwen-code", "auth": "oauth-alibaba", "models": ["qwen3-coder-plus"] }
+  ],
+  "compression": "stacked",
+  "notes": "v0.1 этот файл — справочный. v0.2 будет инжектить combo через REST API OmniRoute при первом запуске."
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "krasavacode",
+  "version": "0.1.0",
+  "description": "KRASAVACODE — однокнопочный бесплатный вайбкодинг для учеников. Claude Code на бесплатных провайдерах через локальный gateway.",
+  "type": "module",
+  "bin": {
+    "krasavacode": "bin/krasavacode.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "config",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "start": "node bin/krasavacode.js",
+    "build:binaries": "bun build --compile --target=bun-darwin-arm64 ./bin/krasavacode.js --outfile dist/krasavacode-mac-arm64 && bun build --compile --target=bun-darwin-x64 ./bin/krasavacode.js --outfile dist/krasavacode-mac-x64 && bun build --compile --target=bun-windows-x64 ./bin/krasavacode.js --outfile dist/krasavacode.exe && bun build --compile --target=bun-linux-x64 ./bin/krasavacode.js --outfile dist/krasavacode-linux-x64"
+  },
+  "keywords": [
+    "claude-code",
+    "ai",
+    "cli",
+    "vibecoding",
+    "free",
+    "education"
+  ],
+  "license": "MIT"
+}

package/src/doctor.js

@@ -0,0 +1,75 @@
+import { spawn } from 'node:child_process';
+import { homedir, platform, arch, totalmem } from 'node:os';
+import { join } from 'node:path';
+import { access, readFile } from 'node:fs/promises';
+import net from 'node:net';
+
+const ROOT = join(homedir(), '.krasavacode');
+
+function spawnCmd(cmd, args) {
+  return new Promise(resolve => {
+    const c = spawn(cmd, args, { stdio: 'pipe' });
+    let out = '';
+    c.stdout.on('data', d => out += d);
+    c.stderr.on('data', d => out += d);
+    c.on('error', () => resolve({ ok: false, out: 'not found' }));
+    c.on('exit', code => resolve({ ok: code === 0, out: out.trim() }));
+  });
+}
+
+async function checkPort(port) {
+  return new Promise(resolve => {
+    const srv = net.createServer();
+    srv.once('error', () => resolve(false));
+    srv.once('listening', () => srv.close(() => resolve(true)));
+    srv.listen(port, '127.0.0.1');
+  });
+}
+
+async function checkNetwork(url) {
+  try {
+    const res = await fetch(url, { signal: AbortSignal.timeout(5000) });
+    return res.ok || (res.status >= 200 && res.status < 500);
+  } catch { return false; }
+}
+
+const check = (label, ok, detail) =>
+  console.log(`  ${ok ? '✅' : '❌'} ${label}${detail ? ' — ' + detail : ''}`);
+
+export async function runDoctor() {
+  console.log('🩺 KRASAVACODE doctor\n');
+
+  console.log('Система:');
+  console.log(`  ${platform()}/${arch()}  RAM ${(totalmem() / 1024 / 1024 / 1024).toFixed(1)} GB`);
+  console.log(`  Node ${process.version}\n`);
+
+  console.log('Бинарники:');
+  const npm = await spawnCmd('npm', ['--version']);
+  check('npm', npm.ok, npm.out);
+
+  const ext = platform() === 'win32' ? '.cmd' : '';
+  const claudeBin = join(ROOT, 'runtime', 'node_modules', '.bin', 'claude' + ext);
+  const ccrBin = join(ROOT, 'runtime', 'node_modules', '.bin', 'ccr' + ext);
+  const haveClaude = await access(claudeBin).then(() => true).catch(() => false);
+  const haveCcr = await access(ccrBin).then(() => true).catch(() => false);
+  check('claude (runtime)', haveClaude, haveClaude ? claudeBin : 'не установлен — будет поставлен при `krasavacode`');
+  check('ccr / claude-code-router (runtime)', haveCcr, haveCcr ? ccrBin : 'не установлен — будет поставлен при `krasavacode`');
+
+  console.log('\nСеть:');
+  check('npm registry', await checkNetwork('https://registry.npmjs.org/'));
+  check('Pollinations', await checkNetwork('https://text.pollinations.ai/openai/chat/completions'));
+
+  console.log('\nПорты:');
+  check('3456 (claude-code-router)', await checkPort(3456), 'свободен или используется ccr');
+  check('20128 (omniroute upgrade)', await checkPort(20128));
+
+  console.log('\nState:');
+  try {
+    const state = JSON.parse(await readFile(join(ROOT, 'state.json'), 'utf8'));
+    console.log(JSON.stringify(state, null, 2).split('\n').map(l => '  ' + l).join('\n'));
+  } catch {
+    console.log('  пусто (запусти `krasavacode` хотя бы раз)');
+  }
+
+  console.log('');
+}

package/src/hub.js

@@ -0,0 +1,97 @@
+import { spawn } from 'node:child_process';
+import { setTimeout as sleep } from 'node:timers/promises';
+import { CCR_PORT } from './preset.js';
+
+const HOST = '127.0.0.1';
+const PORT = CCR_PORT;
+
+async function probe() {
+  const url = `http://${HOST}:${PORT}/`;
+  try {
+    const res = await fetch(url, { signal: AbortSignal.timeout(2000) });
+    // CCR returns any 2xx/3xx/4xx — any HTTP response means it's listening
+    return res.status !== undefined;
+  } catch { return false; }
+}
+
+async function isAlreadyRunning() {
+  return await probe();
+}
+
+async function waitForHealthy(timeoutMs) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    if (await probe()) return true;
+    await sleep(500);
+  }
+  return false;
+}
+
+export async function startHub(paths) {
+  const baseUrl = `http://${HOST}:${PORT}`;
+
+  // CCR is a singleton: one server per machine on port 3456. If something
+  // is already there, hope it's a healthy CCR — don't start a second one.
+  if (await isAlreadyRunning()) {
+    return { process: null, port: PORT, baseUrl, ownedByUs: false };
+  }
+
+  process.stdout.write(`🚀 Поднимаю локальный gateway на порту ${PORT}… `);
+
+  const child = spawn(paths.ccrBin, ['start'], {
+    stdio: process.env.KRASAVACODE_DEBUG ? 'inherit' : 'pipe',
+    detached: false,
+  });
+
+  let stderrTail = '';
+  if (child.stderr) {
+    child.stderr.on('data', d => {
+      stderrTail = (stderrTail + d.toString()).slice(-2000);
+    });
+  }
+  if (child.stdout) {
+    child.stdout.on('data', d => {
+      stderrTail = (stderrTail + d.toString()).slice(-2000);
+    });
+  }
+
+  let exitedEarly = false;
+  child.once('exit', code => {
+    exitedEarly = true;
+    if (code !== 0 && code !== null) {
+      console.error(`\n❌ ccr упал с кодом ${code}.`);
+    }
+  });
+
+  const ok = await waitForHealthy(30000);
+
+  if (!ok) {
+    if (!child.killed) child.kill('SIGTERM');
+    if (stderrTail) console.error('\n--- ccr output ---\n' + stderrTail);
+    throw new Error(`claude-code-router не поднялся за 30s на ${baseUrl}`);
+  }
+
+  console.log('OK');
+
+  if (exitedEarly) {
+    // Maybe CCR daemonised; check if endpoint is alive
+    if (!(await probe())) {
+      throw new Error('ccr процесс завершился, но порт не отвечает');
+    }
+  }
+
+  return { process: child, port: PORT, baseUrl, ownedByUs: true };
+}
+
+export async function stopHub(hub) {
+  if (!hub) return;
+  if (!hub.ownedByUs) return; // we didn't start it; leave it running for the user
+  if (!hub.process || hub.process.killed) return;
+
+  hub.process.kill('SIGTERM');
+  await Promise.race([
+    new Promise(r => hub.process.once('exit', r)),
+    sleep(5000),
+  ]);
+  if (!hub.process.killed) hub.process.kill('SIGKILL');
+}

package/src/launch.js

@@ -0,0 +1,38 @@
+import { spawn } from 'node:child_process';
+
+const PLACEHOLDER_TOKEN = 'sk-krasavacode-local';
+
+export async function launchClaude(paths, hub /*, detection */) {
+  const env = {
+    ...process.env,
+    ANTHROPIC_BASE_URL: hub.baseUrl,
+    ANTHROPIC_AUTH_TOKEN: PLACEHOLDER_TOKEN,
+    ANTHROPIC_API_KEY: PLACEHOLDER_TOKEN,
+    DISABLE_AUTOUPDATER: '1',
+    DISABLE_TELEMETRY: '1',
+    DISABLE_ERROR_REPORTING: '1',
+    // Tell Claude Code which model to ask for. CCR will route any of these
+    // to Pollinations via Router.default.
+    ANTHROPIC_MODEL: process.env.ANTHROPIC_MODEL || 'claude-sonnet-4-5',
+  };
+
+  const passthroughArgs = process.argv.slice(2).filter(a => !['doctor', 'upgrade'].includes(a));
+
+  console.log('');
+  console.log('━'.repeat(58));
+  console.log('  KRASAVACODE — вайбкодинг через локальный hub');
+  console.log('  Hub: ' + hub.baseUrl + '  (claude-code-router → Pollinations)');
+  console.log('  Пиши задачу обычным языком, ИИ сделает.');
+  console.log('━'.repeat(58));
+  console.log('');
+
+  return new Promise((resolve, reject) => {
+    const child = spawn(paths.claudeBin, passthroughArgs, {
+      env,
+      stdio: 'inherit',
+    });
+
+    child.on('error', reject);
+    child.on('exit', () => resolve());
+  });
+}

package/src/preset.js

@@ -0,0 +1,84 @@
+import { mkdir, readFile, writeFile, copyFile, access } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join, dirname } from 'node:path';
+
+const CCR_DIR = join(homedir(), '.claude-code-router');
+const CCR_CONFIG = join(CCR_DIR, 'config.json');
+const STATE_FILE = join(homedir(), '.krasavacode', 'state.json');
+
+const KRASAVACODE_MARKER = 'krasavacode/managed';
+
+const FREE_CONFIG = {
+  HOST: '127.0.0.1',
+  PORT: 3456,
+  LOG: false,
+  API_TIMEOUT_MS: 600000,
+  Providers: [
+    {
+      name: 'pollinations',
+      api_base_url: 'https://text.pollinations.ai/openai/chat/completions',
+      api_key: 'public',
+      models: ['openai', 'openai-fast', 'gpt-oss-20b'],
+    },
+  ],
+  Router: {
+    default: 'pollinations,openai',
+    background: 'pollinations,openai-fast',
+    think: 'pollinations,openai',
+    longContext: 'pollinations,openai',
+    longContextThreshold: 60000,
+  },
+  // Marker so future runs know this config is ours and we may overwrite it.
+  // If a user has manually edited config (no marker), we leave it alone.
+  _krasavacode: KRASAVACODE_MARKER,
+};
+
+async function readState() {
+  try { return JSON.parse(await readFile(STATE_FILE, 'utf8')); }
+  catch { return {}; }
+}
+async function writeState(s) {
+  await writeFile(STATE_FILE, JSON.stringify(s, null, 2));
+}
+
+async function exists(p) {
+  return access(p).then(() => true).catch(() => false);
+}
+
+/**
+ * Writes a default claude-code-router config pointing at Pollinations
+ * (free, no-API-key). Backs up any existing user config before overwriting.
+ *
+ * Returns { mode: 'anthropic-direct' } so launch.js stays generic.
+ */
+export async function ensurePreset(/* hub unused in CCR mode */) {
+  await mkdir(CCR_DIR, { recursive: true });
+  const state = await readState();
+
+  if (await exists(CCR_CONFIG)) {
+    let existing;
+    try { existing = JSON.parse(await readFile(CCR_CONFIG, 'utf8')); }
+    catch { existing = null; }
+
+    const isOurs = existing?._krasavacode === KRASAVACODE_MARKER;
+
+    if (!isOurs && !state.userConfigBackedUp) {
+      const backupPath = `${CCR_CONFIG}.backup-${Date.now()}`;
+      await copyFile(CCR_CONFIG, backupPath);
+      state.userConfigBackedUp = backupPath;
+      await writeState(state);
+      console.log(`💾 Найден свой config.json у claude-code-router — сохранил резервную копию: ${backupPath}`);
+    }
+
+    if (isOurs) {
+      // Already managed by us; rewrite each time so updates roll out.
+      await writeFile(CCR_CONFIG, JSON.stringify(FREE_CONFIG, null, 2));
+      return { mode: 'anthropic-direct' };
+    }
+  }
+
+  await writeFile(CCR_CONFIG, JSON.stringify(FREE_CONFIG, null, 2));
+  return { mode: 'anthropic-direct' };
+}
+
+export const CCR_PORT = FREE_CONFIG.PORT;

package/src/runtime.js

@@ -0,0 +1,112 @@
+import { spawn } from 'node:child_process';
+import { mkdir, access, readFile, writeFile } from 'node:fs/promises';
+import { homedir, platform } from 'node:os';
+import { join } from 'node:path';
+
+const ROOT = join(homedir(), '.krasavacode');
+const RUNTIME = join(ROOT, 'runtime');
+const STATE_FILE = join(ROOT, 'state.json');
+
+const REQUIRED_PACKAGES = [
+  '@anthropic-ai/claude-code@latest',
+  '@musistudio/claude-code-router@latest',
+];
+
+function exists(path) {
+  return access(path).then(() => true).catch(() => false);
+}
+
+async function readState() {
+  try {
+    return JSON.parse(await readFile(STATE_FILE, 'utf8'));
+  } catch {
+    return {};
+  }
+}
+
+async function writeState(state) {
+  await writeFile(STATE_FILE, JSON.stringify(state, null, 2));
+}
+
+function spawnCmd(cmd, args, opts = {}) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(cmd, args, { stdio: opts.silent ? 'pipe' : 'inherit', ...opts });
+    let stdout = '', stderr = '';
+    if (opts.silent) {
+      child.stdout.on('data', d => { stdout += d; });
+      child.stderr.on('data', d => { stderr += d; });
+    }
+    child.on('error', reject);
+    child.on('exit', code => {
+      if (code === 0) resolve({ stdout, stderr });
+      else reject(new Error(`${cmd} exited with code ${code}: ${stderr}`));
+    });
+  });
+}
+
+async function ensureNpm() {
+  try {
+    await spawnCmd('npm', ['--version'], { silent: true });
+  } catch {
+    throw new Error(
+      'npm не найден в PATH. Установи Node.js (≥20) с https://nodejs.org и перезапусти терминал.'
+    );
+  }
+}
+
+async function installPackages() {
+  console.log('📦 Устанавливаю компоненты (один раз)…');
+  await mkdir(RUNTIME, { recursive: true });
+
+  const pkgPath = join(RUNTIME, 'package.json');
+  if (!(await exists(pkgPath))) {
+    await writeFile(pkgPath, JSON.stringify({
+      name: 'krasavacode-runtime',
+      private: true,
+      version: '0.0.0',
+      dependencies: {},
+    }, null, 2));
+  }
+
+  await spawnCmd('npm', [
+    'install',
+    '--prefix', RUNTIME,
+    '--no-audit',
+    '--no-fund',
+    '--loglevel=error',
+    ...REQUIRED_PACKAGES,
+  ]);
+}
+
+function binPath(name) {
+  const ext = platform() === 'win32' ? '.cmd' : '';
+  return join(RUNTIME, 'node_modules', '.bin', name + ext);
+}
+
+export async function ensureRuntime() {
+  await ensureNpm();
+  await mkdir(ROOT, { recursive: true });
+
+  const state = await readState();
+  const ccrBin = binPath('ccr');
+  const claudeBin = binPath('claude');
+
+  const haveCcr = await exists(ccrBin);
+  const haveClaude = await exists(claudeBin);
+
+  if (!haveCcr || !haveClaude || !state.installedAt) {
+    await installPackages();
+    state.installedAt = new Date().toISOString();
+    await writeState(state);
+    console.log('✅ Готово.\n');
+  }
+
+  return {
+    root: ROOT,
+    runtime: RUNTIME,
+    ccrBin,
+    claudeBin,
+    state,
+    saveState: writeState,
+  };
+}

package/src/upgrade.js

@@ -0,0 +1,64 @@
+import { spawn } from 'node:child_process';
+import { mkdir, access, writeFile } from 'node:fs/promises';
+import { homedir, platform } from 'node:os';
+import { join } from 'node:path';
+
+const ROOT = join(homedir(), '.krasavacode');
+const RUNTIME = join(ROOT, 'runtime');
+
+function binPath(name) {
+  const ext = platform() === 'win32' ? '.cmd' : '';
+  return join(RUNTIME, 'node_modules', '.bin', name + ext);
+}
+
+function exists(p) { return access(p).then(() => true).catch(() => false); }
+
+function spawnP(cmd, args, opts = {}) {
+  return new Promise((resolve, reject) => {
+    const c = spawn(cmd, args, { stdio: 'inherit', ...opts });
+    c.on('error', reject);
+    c.on('exit', code => code === 0 ? resolve() : reject(new Error(`${cmd} exited ${code}`)));
+  });
+}
+
+function openBrowser(url) {
+  const cmd = platform() === 'darwin' ? 'open'
+    : platform() === 'win32' ? 'start'
+    : 'xdg-open';
+  const args = platform() === 'win32' ? ['', url] : [url];
+  spawn(cmd, args, { detached: true, stdio: 'ignore', shell: platform() === 'win32' }).unref();
+}
+
+export async function runUpgrade() {
+  console.log('🔧 KRASAVACODE upgrade');
+  console.log('   Pollinations покрывает первые шаги, но для серьёзных проектов');
+  console.log('   стоит подключить более мощные модели бесплатно через OmniRoute:');
+  console.log('   • Kiro AI — Claude Sonnet/Haiku через AWS Builder ID');
+  console.log('   • Qoder — Kimi K2 / Qwen3-Coder / DeepSeek-R1');
+  console.log('   • Qwen Code — 4 модели Alibaba');
+  console.log('   • LongCat — 50M токенов в день\n');
+
+  const omniBin = binPath('omniroute');
+  if (!(await exists(omniBin))) {
+    console.log('📦 Ставлю omniroute (один раз)…');
+    await mkdir(RUNTIME, { recursive: true });
+    const pkgPath = join(RUNTIME, 'package.json');
+    if (!(await exists(pkgPath))) {
+      await writeFile(pkgPath, JSON.stringify({ name: 'krasavacode-runtime', private: true, version: '0.0.0' }, null, 2));
+    }
+    await spawnP('npm', ['install', '--prefix', RUNTIME, '--no-audit', '--no-fund', 'omniroute@latest']);
+    console.log('✅ Готово.\n');
+  }
+
+  console.log('🌐 Открываю дашборд OmniRoute в браузере: http://localhost:20128');
+  console.log('   В дашборде: Providers → Add → выбирай Kiro / Qoder / Pollinations.');
+  console.log('   После настройки нажми Ctrl+C тут, потом обычная команда `krasavacode`.\n');
+
+  setTimeout(() => openBrowser('http://localhost:20128'), 3000);
+
+  process.on('SIGINT', () => process.exit(0));
+
+  await spawnP(omniBin, ['--no-open'], {
+    env: { ...process.env, REQUIRE_API_KEY: 'false', DATA_DIR: ROOT },
+  });
+}