📦 Deskripsi

@vei-ai-cli adalah toolkit profesional super‑lengkap untuk mengakses seluruh kekuatan NVIDIA AI Platform langsung dari terminal maupun kode TypeScript/JavaScript Anda.
Dibangun di atas arsitektur resource‑oriented modern dengan dukungan ESM + CommonJS, type definitions penuh, dan streaming berperforma tinggi, paket ini memberikan kendali total atas model AI, sesi percakapan, memori, agen, keterampilan (skills), penyimpanan (vaults), deployment, dan masih banyak lagi.

Ditenagai oleh 45+ tahun pengalaman membangun sistem berskala enterprise, kini dikemas dalam satu CLI yang elegan — siap mempersingkat siklus pengembangan AI Anda dari hitungan minggu menjadi hitungan jam.

✨ Fitur Utama

| Kategori | Kemampuan | |----------|------------| | 🔑 Kredensial & Autentikasi | API key via environment, rantai kredensial, token identitas, OAuth, dan token caching otomatis. | | 🧠 Model Dinamis | Gonta‑ganti model dengan mudah – mulai dari minimaxai/minimax-m3 hingga model NVIDIA lain. | | 🎯 Multimodal | Kirim teks, gambar (URL/base64), dan video bersamaan. | | ⚡ Streaming Real‑time | Server‑sent events dan chunked transfer langsung ke stdout atau callback Anda. | | 🧩 Resource Management | Kelola semua entitas sebagai resources: messages, batches, models, completions, agents, dll. | | 🤖 Agents & Skills | Buat, latih, dan luncurkan agen AI dengan keterampilan khusus dan memori. | | 🧠 Memory Stores | Simpan dan kelola memori jangka pendek/panjang untuk sesi atau agen. | | 🗄️ Vaults & Credentials | Simpan kredensial rahasia, token, dan konfigurasi dalam vault terenkripsi. | | 🧪 Beta Features | Seluruh fitur eksperimental dari NVIDIA AI siap dicoba: Agents, Environments, Memory Stores, dll. | | 🛠️ Tool Runner | Jalankan alat kustom di sisi server dengan kontrol kompaksi pesan dan penanganan error. | | 📡 Webhooks & Events | Atur webhooks untuk event‑driven reactions pada berbagai resource. | | ⚙️ Middleware | Tambahkan middleware kustom ke client API untuk logging, retry, atau modifikasi request. | | 🚀 CLI Langsung | Eksekusi perintah AI langsung dari terminal melalui bin/cli. |

🚀 Instalasi Cepat

# Instalasi global untuk CLI
npm install -g @vei-ai-cli

# Atau instalasi sebagai library di proyek Anda
npm install @vei-ai-cli

⚡ Penggunaan Dasar

🖥️ Via CLI (Terminal)

# Set API Key (Linux/Mac)
export NVIDIA_API_KEY="nvapi-..."
# Windows PowerShell: $env:NVIDIA_API_KEY="nvapi-..."

# Jalankan chat streaming
vei-ai-cli chat --model "minimaxai/minimax-m3" --prompt "Halo, dunia!"

# Lihat model yang tersedia
vei-ai-cli models

💻 Via Library (TypeScript/JavaScript)

import VeiAI from '@vei-ai-cli';

const client = new VeiAI({ apiKey: process.env.NVIDIA_API_KEY });

// Streaming chat
const stream = await client.resources.completions.create({
  model: 'minimaxai/minimax-m3',
  messages: [{ role: 'user', content: 'Ceritakan tentang AI.' }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content || '');
}

🏗️ Arsitektur

Proyek ini menggunakan arsitektur modular yang ketat dan terorganisir:

• core/: Lapisan dasar (API, streaming, middleware, error handling).
• resources/: Definisi endpoint (models, completions, beta features).
• lib/: Komponen lanjutan (credentials chain, tools, parser).
• helpers/: Utilitas (Zod integration, JSON schema transformation).
• internal/: Utilitas internal (decoders, qs, platform detection).

🤝 Berkontribusi

Proyek ini terbuka untuk kontribusi! Silakan buka issue atau kirim pull request.

📄 Lisensi

MIT © 2026 Vei AI Team.
Dibangun dengan cinta dan pengalaman 45 tahun di dunia software engineering.