playbooks

home / skills / jeremylongshore / claude-code-plugins-plus-skills / vastai-install-auth

vastai-install-auth skill

/plugins/saas-packs/vastai-pack/skills/vastai-install-auth

This skill helps you install and configure Vast.ai SDK/CLI authentication for seamless project integration.

npx playbooks add skill jeremylongshore/claude-code-plugins-plus-skills --skill vastai-install-auth

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
2.2 KB
---
name: vastai-install-auth
description: |
  Install and configure Vast.ai SDK/CLI authentication.
  Use when setting up a new Vast.ai integration, configuring API keys,
  or initializing Vast.ai in your project.
  Trigger with phrases like "install vastai", "setup vastai",
  "vastai auth", "configure vastai API key".
allowed-tools: Read, Write, Edit, Bash(npm:*), Bash(pip:*), Grep
version: 1.0.0
license: MIT
author: Jeremy Longshore <[email protected]>
---

# Vast.ai Install & Auth

## Overview
Set up Vast.ai SDK/CLI and configure authentication credentials.

## Prerequisites
- Node.js 18+ or Python 3.10+
- Package manager (npm, pnpm, or pip)
- Vast.ai account with API access
- API key from Vast.ai dashboard

## Instructions

### Step 1: Install SDK
```bash
# Node.js
npm install @vastai/sdk

# Python
pip install vastai
```

### Step 2: Configure Authentication
```bash
# Set environment variable
export VASTAI_API_KEY="your-api-key"

# Or create .env file
echo 'VASTAI_API_KEY=your-api-key' >> .env
```

### Step 3: Verify Connection
```typescript
// Test connection code here
```

## Output
- Installed SDK package in node_modules or site-packages
- Environment variable or .env file with API key
- Successful connection verification output

## Error Handling
| Error | Cause | Solution |
|-------|-------|----------|
| Invalid API Key | Incorrect or expired key | Verify key in Vast.ai dashboard |
| Rate Limited | Exceeded quota | Check quota at https://docs.vastai.com |
| Network Error | Firewall blocking | Ensure outbound HTTPS allowed |
| Module Not Found | Installation failed | Run `npm install` or `pip install` again |

## Examples

### TypeScript Setup
```typescript
import { Vast.aiClient } from '@vastai/sdk';

const client = new Vast.aiClient({
  apiKey: process.env.VASTAI_API_KEY,
});
```

### Python Setup
```python
from vastai import Vast.aiClient

client = Vast.aiClient(
    api_key=os.environ.get('VASTAI_API_KEY')
)
```

## Resources
- [Vast.ai Documentation](https://docs.vastai.com)
- [Vast.ai Dashboard](https://api.vastai.com)
- [Vast.ai Status](https://status.vastai.com)

## Next Steps
After successful auth, proceed to `vastai-hello-world` for your first API call.

Overview

This skill installs the Vast.ai SDK/CLI and configures authentication so your app can call Vast.ai APIs. It walks through installing the Python or Node package, setting an API key via environment or .env, and verifying the connection. Use it to get a safe, repeatable auth setup for development or CI.

How this skill works

The skill installs the official Vast.ai client for Node.js or Python and sets the VASTAI_API_KEY environment variable or writes it to a .env file. It provides a simple verification step that initializes a client with the key and performs a test request to confirm connectivity. It also lists common errors and remediation steps.

When to use it

  • Setting up a new Vast.ai integration in a project
  • Configuring or rotating a Vast.ai API key
  • Preparing CI/CD or container environments that need Vast.ai access
  • Onboarding a developer to use Vast.ai locally
  • Troubleshooting authentication or connectivity issues

Best practices

  • Keep API keys out of source control; use environment variables or secrets management
  • Use least-privilege API keys if Vast.ai supports scopes or limited keys
  • Store .env only in local development and use CI secrets for automated builds
  • Verify connectivity immediately after installing to catch network or rate-limit issues
  • Document which runtime (Node/Python) and package manager your project uses

Example use cases

  • Local development: pip install vastai, export VASTAI_API_KEY, run a quick client.list call to verify
  • Node project: npm install @vastai/sdk, add VASTAI_API_KEY to your .env and load with dotenv before creating the client
  • CI pipeline: inject the VASTAI_API_KEY as a secret environment variable and run a lightweight API call in a pre-deploy check
  • Key rotation: update the environment variable or CI secret, then run the verification step in a staging environment to confirm
  • Troubleshooting: use the provided error guidance to identify invalid keys, rate limits, or network blocks

FAQ

How do I install for Node or Python?

For Node run npm install @vastai/sdk. For Python run pip install vastai. Choose the package matching your project runtime.

Where should I store the API key?

Prefer environment variables or your CI secret store. Use a .env file only for local development and never commit it to version control.

How can I verify the key is working?

Initialize the client using VASTAI_API_KEY and call a simple endpoint (for example listing resources). Successful response confirms auth and network access.