aiesthetic-cli 1.0.0

package/README.md

@@ -0,0 +1,50 @@
+# aiesthetic-cli
+
+The official Asset Engine for the AIesthetic platform. Generate and download high-quality visual assets (12s cinematic videos and 360 animation frames) directly to your local workspace.
+
+## Installation
+
+You can run the CLI without installing it using `npx`:
+
+```bash
+npx aiesthetic-cli "Design a luxury watch website" "cinematic"
+```
+
+## Setup
+
+The CLI requires an API key to function. Create a `.env` file in your working directory:
+
+```env
+AIESTHETIC_API_KEY=your_live_key_here
+```
+
+## Usage
+
+```bash
+npx aiesthetic-cli <prompt> [style]
+```
+
+- **prompt**: Descriptive text for your scene (e.g., "A futuristic flying car")
+- **style**: (Optional) Visual style. Options: `cinematic` (default), `modern`, `bold`, etc.
+
+## Output
+
+The CLI creates a structured directory:
+
+```text
+aiesthetic_assets/
+└── req_abc123/
+    ├── frames/           # 360 sequential frames (30fps)
+    ├── video.mp4         # 12s high-resolution video
+    ├── README.md         # Implementation instructions
+    └── cursor-prompt.txt # Prompt for your AI coding agent
+```
+
+## Features
+
+- **Multi-threaded Downloads**: Fast asset retrieval with parallel streams.
+- **Zero-Config**: Works out of the box with `npx`.
+- **AI Agent Ready**: Provides pre-formatted prompts for tools like Cursor and Windsurf.
+
+---
+© 2024 AIesthetic Team. All rights reserved.

package/bin/cli.js

@@ -0,0 +1,192 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+const crypto = require('crypto');
+
+// ─────────────────────────────────────────
+// COLORS & UI UTILS
+// ─────────────────────────────────────────
+const color = {
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+  cyan: "\x1b[36m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  red: "\x1b[31m",
+  dim: "\x1b[2m",
+};
+
+// ─────────────────────────────────────────
+// ENV LOADER
+// ─────────────────────────────────────────
+function loadEnv() {
+  if (fs.existsSync('.env')) {
+    const envFile = fs.readFileSync('.env', 'utf-8');
+    envFile.split('\n').forEach(line => {
+      const parts = line.split('=');
+      if (parts.length >= 2) {
+        const key = parts[0].trim();
+        const value = parts.slice(1).join('=').trim().replace(/['"]/g, '');
+        process.env[key] = value;
+      }
+    });
+  }
+}
+
+loadEnv();
+
+const CONFIG = {
+  BASE_URL: 'https://us-central1-aiestheticbackend.cloudfunctions.net/api/v1',
+  API_KEY: process.env.AIESTHETIC_API_KEY,
+  PROMPT: process.argv[2],
+  STYLE: process.argv[3] || 'cinematic',
+  CONCURRENT_DOWNLOADS: 10,
+};
+
+// ─────────────────────────────────────────
+// CORE UTILS
+// ─────────────────────────────────────────
+async function request(method, path, body = null) {
+  return new Promise((resolve, reject) => {
+    const options = {
+      method,
+      hostname: 'us-central1-aiestheticbackend.cloudfunctions.net',
+      path: `/api${path}`,
+      headers: {
+        'Content-Type': 'application/json',
+        'x-api-key': CONFIG.API_KEY,
+      },
+      timeout: 900000,
+    };
+
+    const req = https.request(options, (res) => {
+      let data = '';
+      res.on('data', (chunk) => data += chunk);
+      res.on('end', () => {
+        try {
+          const parsed = JSON.parse(data);
+          if (res.statusCode >= 400) reject(parsed);
+          else resolve(parsed);
+        } catch (e) {
+          reject(new Error(`Failed to parse response: ${data}`));
+        }
+      });
+    });
+
+    req.on('error', reject);
+    if (body) req.write(JSON.stringify(body));
+    req.end();
+  });
+}
+
+function downloadFile(url, dest) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(dest);
+    https.get(url, (res) => {
+      if (res.statusCode !== 200) {
+        reject(new Error(`Failed to download: ${res.statusCode}`));
+        return;
+      }
+      res.pipe(file);
+      file.on('finish', () => {
+        file.close();
+        resolve();
+      });
+    }).on('error', (err) => {
+      fs.unlink(dest, () => {});
+      reject(err);
+    });
+  });
+}
+
+// ─────────────────────────────────────────
+// MAIN ENGINE
+// ─────────────────────────────────────────
+async function main() {
+  console.log(`\n${color.bold}${color.cyan}╔══════════════════════════════════════════════════════════╗${color.reset}`);
+  console.log(`${color.bold}${color.cyan}║             AIesthetic CLI — Asset Engine                ║${color.reset}`);
+  console.log(`${color.bold}${color.cyan}╚══════════════════════════════════════════════════════════╝${color.reset}\n`);
+
+  if (!CONFIG.API_KEY) {
+    console.log(`${color.red}❌ Error: AIESTHETIC_API_KEY not found.${color.reset}`);
+    console.log(`${color.dim}Please add it to your .env file or export it as an environment variable.${color.reset}\n`);
+    process.exit(1);
+  }
+
+  if (!CONFIG.PROMPT) {
+    console.log(`${color.yellow}⚠️  Usage: npx aiesthetic "Your Prompt" "style"${color.reset}\n`);
+    process.exit(0);
+  }
+
+  try {
+    // 1. Check Credits
+    process.stdout.write(`  ${color.dim}▶${color.reset} Verifying Account... `);
+    const creditInfo = await request('GET', '/v1/credits');
+    console.log(`${color.green}Balance: ${creditInfo.credits} credits${color.reset}`);
+
+    // 2. Generate
+    console.log(`  ${color.dim}▶${color.reset} Generating Assets...`);
+    console.log(`    ${color.dim}Prompt:${color.reset} "${CONFIG.PROMPT}"`);
+    console.log(`    ${color.dim}Style: ${color.reset} ${CONFIG.STYLE}`);
+    console.log(`    ${color.yellow}⏳ Processing through GPU cluster (2-5 mins)...${color.reset}`);
+
+    const startTime = Date.now();
+    const generation = await request('POST', '/v1/generate', {
+      prompt: CONFIG.PROMPT,
+      style: CONFIG.STYLE,
+    });
+
+    const duration = ((Date.now() - startTime) / 1000).toFixed(1);
+    console.log(`    ${color.green}✓ Generation complete in ${duration}s${color.reset}\n`);
+
+    // 3. Download
+    const { assets, requestId } = generation;
+    const outputDir = path.join(process.cwd(), 'aiesthetic_assets', requestId);
+    const framesDir = path.join(outputDir, 'frames');
+
+    console.log(`  ${color.dim}▶${color.reset} Downloading Assets...`);
+    console.log(`    ${color.dim}Target:${color.reset} ${outputDir}`);
+
+    if (!fs.existsSync(framesDir)) fs.mkdirSync(framesDir, { recursive: true });
+
+    // Download Video
+    process.stdout.write(`    ${color.dim}• Downloading video...${color.reset} `);
+    await downloadFile(assets.videoUrl, path.join(outputDir, 'video.mp4'));
+    console.log(`${color.green}done${color.reset}`);
+
+    // Download Frames (Parallel)
+    const frameUrls = assets.frames.urls;
+    process.stdout.write(`    ${color.dim}• Downloading 360 frames...${color.reset} `);
+
+    for (let i = 0; i < frameUrls.length; i += CONFIG.CONCURRENT_DOWNLOADS) {
+      const chunk = frameUrls.slice(i, i + CONFIG.CONCURRENT_DOWNLOADS);
+      await Promise.all(chunk.map((url, idx) => {
+        const frameNum = (i + idx + 1).toString().padStart(4, '0');
+        return downloadFile(url, path.join(framesDir, `frame_${frameNum}.jpg`));
+      }));
+      const progress = Math.round(((i + chunk.length) / frameUrls.length) * 100);
+      process.stdout.write(`\r    ${color.dim}• Downloading 360 frames...${color.reset} ${color.cyan}${progress}%${color.reset}`);
+    }
+    console.log(` ${color.green}complete${color.reset}`);
+
+    // Save Meta
+    fs.writeFileSync(path.join(outputDir, 'README.md'), assets.readme.markdown);
+    fs.writeFileSync(path.join(outputDir, 'cursor-prompt.txt'), assets.readme.cursorPrompt);
+
+    console.log(`\n  ${color.bold}${color.green}✨ GENERATION SUCCESSFUL${color.reset}`);
+    console.log(`  ${color.dim}══════════════════════════════════════════════════════${color.reset}`);
+    console.log(`  ${color.bold}  NEXT STEPS FOR YOUR AI AGENT:${color.reset}`);
+    console.log(`  1. Open the generated README: ${color.cyan}${path.join(outputDir, 'README.md')}${color.reset}`);
+    console.log(`  2. Follow the technical instructions to build the site.`);
+    console.log(`  3. The cursor-prompt.txt contains your ready-to-use system prompt.`);
+    console.log(`  ${color.dim}══════════════════════════════════════════════════════${color.reset}\n`);
+
+  } catch (error) {
+    console.log(`\n${color.red}❌ Error:${color.reset}`, error.message || error.code || error);
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "aiesthetic-cli",
+  "version": "1.0.0",
+  "description": "AIesthetic Asset Engine — Generate and download high-quality visual components from your terminal.",
+  "main": "index.js",
+  "bin": {
+    "aiesthetic": "bin/cli.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "ai",
+    "generative",
+    "vfx",
+    "web-design",
+    "cli",
+    "aiesthetic"
+  ],
+  "author": "AIesthetic Team",
+  "license": "MIT",
+  "dependencies": {
+    "dotenv": "^16.4.5"
+  }
+}