badgr-cli 1.0.20 → 1.0.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "badgr-cli",
-  "version": "1.0.20",
+  "version": "1.0.21",
   "description": "Badgr, run or serve GPU workloads from one command",
   "type": "module",
   "bin": {

package/src/badgr.js

@@ -26,10 +26,14 @@ ${chalk.bold('COMMANDS')}
   ${chalk.cyan('badgr capacity')}               Check what GPU capacity is available right now
 
 ${chalk.bold('EXAMPLES')}
-  ${chalk.dim('# Simplest — Badgr picks the GPU:')}
+  ${chalk.dim('# Simplest — Badgr picks the GPU (RunPod, reliable):')}
   badgr run python train.py
   badgr serve meta-llama/Llama-3.1-8B-Instruct
 
+  ${chalk.dim('# Opt into cheaper budget providers (Vast.ai etc.):')}
+  badgr run python train.py --cheap
+  badgr serve meta-llama/Llama-3.1-8B-Instruct --cheap
+
   ${chalk.dim('# Pin a specific GPU:')}
   badgr run python train.py --gpu A100
   badgr serve meta-llama/Llama-3.1-8B-Instruct --gpu L40S
@@ -44,10 +48,12 @@ ${chalk.bold('EXAMPLES')}
   badgr receipts dep-abc123
 
 ${chalk.bold('badgr run OPTIONS')}
-  --gpu <type>           GPU type (default: auto — Badgr picks cheapest available)
+  --gpu <type>           GPU type (default: auto — Badgr picks best available on RunPod)
+  --cheap                Search budget providers too (Vast.ai etc.) for lower prices
   --image <image>        Docker image (default: python:3.11-slim)
   --count <n>            Number of GPUs (default: 1)
   --region US|EU|AU      Region preference
+  --tier 1|2             Provider tier: 1 = reliable (default), 2 = budget
   --max-price <$/hr>     Hard spend cap per GPU-hour
   --max-runtime <min>    Auto-stop after N minutes (recommended)
   --max-cost <$>         Auto-stop when spend reaches this amount
@@ -55,8 +61,10 @@ ${chalk.bold('badgr run OPTIONS')}
 
 ${chalk.bold('badgr serve OPTIONS')}
   --gpu <type>           GPU type (default: auto — inferred from model size)
+  --cheap                Search budget providers too (Vast.ai etc.) for lower prices
   --count <n>            Number of GPUs (default: 1)
   --region US|EU|AU      Region preference
+  --tier 1|2             Provider tier: 1 = reliable (default), 2 = budget
   --max-price <$/hr>     Hard spend cap per GPU-hour
   --no-wait              Skip endpoint health check
 

package/src/commands/run.js

@@ -19,6 +19,7 @@ export function parseRunArgs(args) {
     if (args[i] === '--count')          { flags.count = parseInt(args[++i], 10); i++; continue; }
     if (args[i] === '--region')         { flags.region = args[++i]; i++; continue; }
     if (args[i] === '--tier')           { flags.tier = args[++i]; i++; continue; }
+    if (args[i] === '--cheap')          { flags.cheap = true; i++; continue; }
     if (args[i] === '--max-price')      { flags.maxPrice = parseFloat(args[++i]); i++; continue; }
     if (args[i] === '--name')           { flags.name = args[++i]; i++; continue; }
     if (args[i] === '--detach')          { flags.detach = true; i++; continue; }
@@ -269,11 +270,12 @@ async function attachToJob(config, depId, { chalk, maxRuntimeMs = null, maxCost
   }
 }
 
-// Ask the backend for the cheapest available GPU right now.
+// Ask the backend for the best available GPU right now.
+// Defaults to tier 1 (RunPod) for reliability; pass tier='2' for budget providers.
 // Returns { gpu, region, price } or null when nothing is available.
-async function findAutoGpu(config, chalk) {
+async function findAutoGpu(config, chalk, tier = '1') {
   try {
-    const params = new URLSearchParams({ max_price: '10' });
+    const params = new URLSearchParams({ max_price: '10', tier });
     return await callApi(`/capacity/auto?${params}`, {
       apiKey: config.apiKey,
       baseUrl: config.baseUrl,
@@ -307,6 +309,12 @@ export async function runCommand(config, args, chalk) {
   const maxRuntimeMs = flags.maxRuntime ? flags.maxRuntime * 60 * 1000 : null;
   const maxCost      = flags.maxCost ?? null;
 
+  // Resolve effective tier: --cheap and --tier 2 opt into budget providers;
+  // everything else defaults to tier 1 (RunPod only) for reliability.
+  const effectiveTier = (flags.cheap || flags.tier === '2' || flags.tier === 'tier2' || flags.tier === 'tier-2')
+    ? '2'
+    : (flags.tier || '1');
+
   // ── Auto GPU selection (no --gpu specified) ────────────────────────────────
   let gpu = flags.gpu ? flags.gpu.toUpperCase().replace('-', '_') : null;
   let autoRegion = null;
@@ -315,12 +323,13 @@ export async function runCommand(config, args, chalk) {
     console.log(chalk.bold('\n⚡ Running GPU job\n'));
     if (command) console.log(`  ${chalk.bold('Command:')}  ${command.join(' ')}`);
     if (image)   console.log(`  ${chalk.bold('Image:')}    ${image}`);
+    if (effectiveTier === '2') console.log(`  ${chalk.dim('(budget mode — searching all providers)')}`);
     console.log();
     process.stdout.write(chalk.dim('  Finding GPU...'));
 
     let best;
     try {
-      best = await findAutoGpu(config, chalk);
+      best = await findAutoGpu(config, chalk, effectiveTier);
     } catch (err) {
       process.stdout.write('\n');
       console.error(chalk.red(`\n  ✗ Could not find GPU capacity: ${err.message}\n`));
@@ -385,7 +394,7 @@ export async function runCommand(config, args, chalk) {
       ...(effectiveRegion ? { region: effectiveRegion } : {}),
       max_price_per_hour: flags.maxPrice,
       name: flags.name,
-      ...(flags.tier ? { tier: flags.tier } : {}),
+      tier: effectiveTier,
     };
   }
 

package/src/commands/serve.js

@@ -18,6 +18,7 @@ export function parseServeArgs(args) {
     if (args[i] === '--count')      { flags.count = parseInt(args[++i], 10); i++; continue; }
     if (args[i] === '--region')     { flags.region = args[++i]; i++; continue; }
     if (args[i] === '--tier')       { flags.tier = args[++i]; i++; continue; }
+    if (args[i] === '--cheap')      { flags.cheap = true; i++; continue; }
     if (args[i] === '--max-price')  { flags.maxPrice = parseFloat(args[++i]); i++; continue; }
     if (args[i] === '--name')       { flags.name = args[++i]; i++; continue; }
     if (args[i] === '--no-wait')    { flags.noWait = true; i++; continue; }
@@ -64,9 +65,15 @@ export async function serveCommand(config, args, chalk) {
   const gpu = flags.gpu ? flags.gpu.toUpperCase().replace('-', '_') : 'AUTO';
   const gpuLabel = gpu === 'AUTO' ? 'auto' : gpu;
 
+  // Default to tier 1 (RunPod) for reliability; --cheap or --tier 2 opts into budget providers.
+  const effectiveTier = (flags.cheap || flags.tier === '2' || flags.tier === 'tier2' || flags.tier === 'tier-2')
+    ? '2'
+    : (flags.tier || '1');
+
   console.log(chalk.bold('\nServing model\n'));
   console.log(`  ${chalk.bold('Model:')}  ${model}`);
   console.log(`  ${chalk.bold('GPU:')}    ${gpuLabel}`);
+  if (effectiveTier === '2') console.log(`  ${chalk.dim('(budget mode — searching all providers)')}`);
   console.log();
   process.stdout.write(chalk.dim('  Finding GPU capacity...\n'));
 
@@ -80,7 +87,7 @@ export async function serveCommand(config, args, chalk) {
       ...(regionOverride || effectiveRegion ? { region: regionOverride || effectiveRegion } : {}),
       max_price_per_hour: flags.maxPrice,
       name: flags.name,
-      ...(flags.tier ? { tier: flags.tier } : {}),
+      tier: effectiveTier,
     };
   }
 

package/tests/commands.test.js

@@ -71,6 +71,21 @@ describe('parseRunArgs', () => {
     const { flags } = parseRunArgs(['python', 'train.py', '--max-cost', '5.00']);
     expect(flags.maxCost).toBe(5.0);
   });
+
+  it('parses --cheap flag', () => {
+    const { flags } = parseRunArgs(['python', 'train.py', '--cheap']);
+    expect(flags.cheap).toBe(true);
+  });
+
+  it('--cheap defaults to falsy when not passed', () => {
+    const { flags } = parseRunArgs(['python', 'train.py']);
+    expect(flags.cheap).toBeFalsy();
+  });
+
+  it('parses --tier 2 flag', () => {
+    const { flags } = parseRunArgs(['python', 'train.py', '--tier', '2']);
+    expect(flags.tier).toBe('2');
+  });
 });
 
 describe('classifyFailure', () => {
@@ -187,6 +202,16 @@ describe('parseServeArgs', () => {
     const { model } = parseServeArgs(['--gpu', 'RTX_4090']);
     expect(model).toBeNull();
   });
+
+  it('parses --cheap flag', () => {
+    const { flags } = parseServeArgs(['my/model', '--cheap']);
+    expect(flags.cheap).toBe(true);
+  });
+
+  it('--cheap defaults to falsy when not passed', () => {
+    const { flags } = parseServeArgs(['my/model']);
+    expect(flags.cheap).toBeFalsy();
+  });
 });
 
 describe('promptFallback output', () => {