@fangs/create-fang 1.0.0

package/index.js

@@ -0,0 +1,276 @@
+#!/usr/bin/env node
+
+/**
+ * create-fang — Scaffold a new FANG agent instance
+ *
+ * Usage:
+ *   npx create-fang [directory]
+ *   npx create-fang my-agent
+ *   npx create-fang doctor       — health check
+ */
+
+const { execSync } = require('child_process');
+const { mkdirSync, writeFileSync, existsSync, readFileSync } = require('fs');
+const { resolve, basename } = require('path');
+const readline = require('readline');
+
+const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+const ask = (q) => new Promise((r) => rl.question(q, r));
+
+const g = '\x1b[32m';
+const c = '\x1b[36m';
+const y = '\x1b[33m';
+const red = '\x1b[31m';
+const d = '\x1b[2m';
+const b = '\x1b[1m';
+const r = '\x1b[0m';
+
+const VERSION = '1.0.0';
+const REPO = 'https://github.com/fang-agent/fang.git';
+
+const SNAKE = `
+${g}    ╭──────────╮
+    │  🐍 FANG │
+    │  v${VERSION} │
+    ╰──────────╯${r}
+`;
+
+// ── Doctor Command ─────────────────────────────
+if (process.argv[2] === 'doctor') {
+  console.log(SNAKE);
+  console.log(`${b}  FANG Doctor — Health Check${r}\n`);
+
+  const checks = [];
+
+  // Node version
+  const nodeVersion = process.version;
+  const major = parseInt(nodeVersion.slice(1));
+  checks.push({ name: 'Node.js', status: major >= 18 ? 'ok' : 'fail', detail: `${nodeVersion}${major < 18 ? ' (need ≥18)' : ''}` });
+
+  // pnpm
+  try {
+    const pnpmVersion = execSync('pnpm --version', { encoding: 'utf-8' }).trim();
+    checks.push({ name: 'pnpm', status: 'ok', detail: pnpmVersion });
+  } catch {
+    checks.push({ name: 'pnpm', status: 'warn', detail: 'not installed (using npm)' });
+  }
+
+  // Git
+  try {
+    execSync('git --version', { encoding: 'utf-8' });
+    checks.push({ name: 'git', status: 'ok', detail: 'installed' });
+  } catch {
+    checks.push({ name: 'git', status: 'fail', detail: 'not installed' });
+  }
+
+  // Docker
+  try {
+    execSync('docker info 2>/dev/null', { encoding: 'utf-8', timeout: 5000 });
+    checks.push({ name: 'Docker', status: 'ok', detail: 'running' });
+  } catch {
+    checks.push({ name: 'Docker', status: 'warn', detail: 'not running (optional — needed for sandbox)' });
+  }
+
+  // SoX (for voice)
+  try {
+    execSync('which rec 2>/dev/null || which sox 2>/dev/null', { encoding: 'utf-8' });
+    checks.push({ name: 'SoX (voice)', status: 'ok', detail: 'installed' });
+  } catch {
+    checks.push({ name: 'SoX (voice)', status: 'warn', detail: 'not installed — brew install sox (needed for voice)' });
+  }
+
+  // .env file
+  if (existsSync('.env')) {
+    const env = readFileSync('.env', 'utf-8');
+    const hasLLM = /^(ANTHROPIC_API_KEY|OPENAI_API_KEY|GROQ_API_KEY)=\S+/m.test(env);
+    checks.push({ name: '.env', status: hasLLM ? 'ok' : 'warn', detail: hasLLM ? 'LLM key configured' : 'no LLM API key found' });
+
+    const channels = [];
+    if (/^TELEGRAM_BOT_TOKEN=\S+/m.test(env)) channels.push('Telegram');
+    if (/^DISCORD_BOT_TOKEN=\S+/m.test(env)) channels.push('Discord');
+    if (/^SLACK_BOT_TOKEN=\S+/m.test(env)) channels.push('Slack');
+    if (/^IMESSAGE_ALLOWED_USERS=\S+/m.test(env)) channels.push('iMessage');
+    if (channels.length > 0) {
+      checks.push({ name: 'Channels', status: 'ok', detail: channels.join(', ') });
+    }
+  } else {
+    checks.push({ name: '.env', status: 'fail', detail: 'missing — create one with your API keys' });
+  }
+
+  // Build check
+  if (existsSync('packages/core/dist/cli.js')) {
+    checks.push({ name: 'Build', status: 'ok', detail: 'compiled' });
+  } else if (existsSync('packages/core')) {
+    checks.push({ name: 'Build', status: 'fail', detail: 'not built — run pnpm build' });
+  }
+
+  // Display results
+  for (const check of checks) {
+    const icon = check.status === 'ok' ? `${g}✓${r}` : check.status === 'warn' ? `${y}⚠${r}` : `${red}✗${r}`;
+    console.log(`  ${icon} ${b}${check.name}${r}: ${d}${check.detail}${r}`);
+  }
+
+  const fails = checks.filter(c => c.status === 'fail').length;
+  const warns = checks.filter(c => c.status === 'warn').length;
+
+  console.log(`\n  ${fails === 0 ? g + '✓ System healthy!' : red + `${fails} issue(s) need fixing`}${r}`);
+  if (warns > 0) console.log(`  ${d}${warns} optional improvement(s)${r}`);
+  console.log('');
+
+  rl.close();
+  process.exit(fails > 0 ? 1 : 0);
+}
+
+// ── Main Wizard ────────────────────────────────
+async function main() {
+  console.log(SNAKE);
+  console.log(`${b}  Create your personal AI agent${r}\n`);
+
+  // Step 1: Directory
+  let dir = process.argv[2];
+  if (!dir) {
+    dir = await ask(`${c}? ${r}Project directory ${d}(my-agent)${r}: `);
+    dir = dir.trim() || 'my-agent';
+  }
+
+  const projectDir = resolve(process.cwd(), dir);
+  const name = basename(projectDir);
+
+  if (existsSync(resolve(projectDir, 'package.json'))) {
+    console.log(`\n${y}  ⚠ "${dir}" already exists${r}`);
+    const ow = await ask(`${c}? ${r}Overwrite config files? ${d}(y/N)${r}: `);
+    if (ow.toLowerCase() !== 'y') { console.log('  Cancelled.'); process.exit(0); }
+  }
+
+  // Step 2: Agent name
+  let agentName = await ask(`\n${c}? ${r}Agent name ${d}(FANG)${r}: `);
+  agentName = agentName.trim() || 'FANG';
+
+  // Step 3: Your name
+  let ownerName = await ask(`${c}? ${r}Your name ${d}(Human)${r}: `);
+  ownerName = ownerName.trim() || 'Human';
+
+  // Step 4: LLM Provider
+  console.log(`\n${b}  LLM Provider${r}\n`);
+  console.log(`  ${g}1${r} Anthropic (Claude) ${d}← recommended${r}`);
+  console.log(`  ${d}2${r} OpenAI (GPT-4)`);
+  console.log(`  ${d}3${r} Groq (fast + free)`);
+  console.log(`  ${d}4${r} Skip\n`);
+
+  const pChoice = (await ask(`${c}? ${r}Choice ${d}(1)${r}: `)).trim() || '1';
+  let anthropicKey = '', openaiKey = '', groqKey = '';
+
+  if (pChoice === '1') { anthropicKey = (await ask(`${c}? ${r}Anthropic API key: `)).trim(); }
+  else if (pChoice === '2') { openaiKey = (await ask(`${c}? ${r}OpenAI API key: `)).trim(); }
+  else if (pChoice === '3') { groqKey = (await ask(`${c}? ${r}Groq API key: `)).trim(); }
+
+  // Step 5: Channels
+  console.log(`\n${b}  Channels${r} ${d}(add more anytime in .env)${r}\n`);
+
+  let telegramToken = '', telegramUser = '', discordToken = '';
+
+  if ((await ask(`${c}? ${r}Telegram? ${d}(y/N)${r}: `)).toLowerCase() === 'y') {
+    console.log(`\n  ${d}Open Telegram → @BotFather → /newbot → copy token${r}\n`);
+    telegramToken = (await ask(`${c}? ${r}Bot token: `)).trim();
+    console.log(`\n  ${d}Telegram → @getmyid_bot → copy your user ID${r}\n`);
+    telegramUser = (await ask(`${c}? ${r}User ID: `)).trim();
+  }
+
+  if ((await ask(`${c}? ${r}Discord? ${d}(y/N)${r}: `)).toLowerCase() === 'y') {
+    console.log(`\n  ${d}discord.com/developers → New App → Bot → copy token${r}\n`);
+    discordToken = (await ask(`${c}? ${r}Bot token: `)).trim();
+  }
+
+  // ── Clone + Build ────────────────────────────
+  console.log(`\n${g}  🐍 Creating ${agentName}...${r}\n`);
+
+  if (!existsSync(resolve(projectDir, 'package.json'))) {
+    console.log(`${d}  Cloning FANG...${r}`);
+    try {
+      execSync(`git clone --depth 1 ${REPO} "${projectDir}"`, { stdio: 'pipe' });
+      execSync(`rm -rf "${resolve(projectDir, '.git')}"`, { stdio: 'pipe' });
+      execSync(`cd "${projectDir}" && git init && git add -A && git commit -m "init: ${agentName}"`, { stdio: 'pipe' });
+    } catch (err) {
+      console.log(`${red}  ✗ Clone failed. Check internet.${r}`);
+      console.log(`${d}  Manual: git clone ${REPO} ${dir}${r}`);
+      rl.close();
+      process.exit(1);
+    }
+  }
+
+  // Create data dirs
+  for (const sub of ['skills', 'plugins', 'logs', 'cache', 'tmp']) {
+    mkdirSync(resolve(projectDir, '.fang', sub), { recursive: true });
+  }
+
+  // Write .env
+  const env = [
+    `# ${agentName} — created ${new Date().toISOString().split('T')[0]}`,
+    `FANG_NAME=${agentName}`,
+    `FANG_OWNER=${ownerName}`,
+    '',
+    '# LLM',
+    anthropicKey ? `ANTHROPIC_API_KEY=${anthropicKey}` : '# ANTHROPIC_API_KEY=',
+    openaiKey ? `OPENAI_API_KEY=${openaiKey}` : '# OPENAI_API_KEY=',
+    groqKey ? `GROQ_API_KEY=${groqKey}` : '# GROQ_API_KEY=',
+    '',
+    '# Channels',
+    telegramToken ? `TELEGRAM_BOT_TOKEN=${telegramToken}` : '# TELEGRAM_BOT_TOKEN=',
+    telegramUser ? `TELEGRAM_ALLOWED_USERS=${telegramUser}` : '# TELEGRAM_ALLOWED_USERS=',
+    discordToken ? `DISCORD_BOT_TOKEN=${discordToken}` : '# DISCORD_BOT_TOKEN=',
+    '# SLACK_BOT_TOKEN=',
+    '# IMESSAGE_ALLOWED_USERS=',
+    '',
+    '# Canvas',
+    'FANG_CANVAS=true',
+    '',
+    '# See docs/ for trading, email, voice, sandbox setup',
+  ].join('\n') + '\n';
+  writeFileSync(resolve(projectDir, '.env'), env);
+
+  // Write SOUL.md
+  writeFileSync(resolve(projectDir, 'SOUL.md'), [
+    `# ${agentName}`,
+    '', `> Level 0: Newborn`, `> Owner: ${ownerName}`, '',
+    '## Personality', '- Curious about everything', '- Asks questions to learn', '- Eager to help', '',
+    '## Tone', 'curious, eager, asks lots of questions', '',
+    '---', '*Auto-generated. Evolves over time.*',
+  ].join('\n') + '\n');
+
+  // Install + build
+  console.log(`${d}  Installing...${r}`);
+  try {
+    execSync('pnpm install 2>&1', { cwd: projectDir, stdio: 'inherit' });
+    console.log(`\n${d}  Building...${r}`);
+    execSync('pnpm build 2>&1', { cwd: projectDir, stdio: 'inherit' });
+  } catch {
+    console.log(`${y}  ⚠ Build issue. Try: cd ${dir} && pnpm install && pnpm build${r}`);
+  }
+
+  // ── Success ──────────────────────────────────
+  const ch = ['CLI'];
+  if (telegramToken) ch.push('Telegram');
+  if (discordToken) ch.push('Discord');
+
+  console.log(`
+${g}  ╔═══════════════════════════════════════╗
+  ║                                       ║
+  ║     🐍 ${agentName} is ready!${' '.repeat(Math.max(0, 21 - agentName.length))}║
+  ║                                       ║
+  ╚═══════════════════════════════════════╝${r}
+
+  ${b}Agent:${r} ${agentName}    ${b}Owner:${r} ${ownerName}
+  ${b}Channels:${r} ${ch.join(', ')}
+  ${b}Canvas:${r} http://127.0.0.1:18791
+
+  ${c}cd ${dir}${r}
+  ${c}pnpm fang${r}
+
+  ${d}${agentName} will introduce itself and start learning.${r}
+  ${d}Run 'npx create-fang doctor' to check system health.${r}
+  `);
+
+  rl.close();
+}
+
+main().catch(err => { console.error(err); rl.close(); process.exit(1); });

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@fangs/create-fang",
+  "version": "1.0.0",
+  "description": "Create a new FANG AI agent instance",
+  "bin": {
+    "create-fang": "./index.js"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "fang",
+    "cli",
+    "personal-ai",
+    "scaffold",
+    "create"
+  ],
+  "author": "FANG",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fang-agent/fang"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "index.js"
+  ]
+}