vastai-hello-world
Create a minimal working Vast.ai example.Use when starting a new Vast.ai integration, testing your setup,or learning basic Vast.ai API patterns.Trigger with phrases like "vastai hello world", "vastai example","vastai quick start", "simple vastai code".
When & Why to Use This Skill
This Claude skill facilitates the rapid integration of Vast.ai GPU rental services by generating a minimal, functional 'Hello World' boilerplate. It is designed to help developers verify their API credentials, test environment configurations, and master basic API patterns in both TypeScript and Python, significantly reducing the setup time for cloud-based compute tasks.
Use Cases
- Initial Integration: Quickly bootstrapping a new project that requires Vast.ai GPU resources by generating ready-to-use client initialization code.
- Environment Validation: Testing if API keys and environment variables are correctly configured and reachable before deploying complex workloads.
- Onboarding & Learning: Providing a clear, executable reference for developers new to the Vast.ai SDK to understand core connection patterns and error handling.
| name | vastai-hello-world |
|---|---|
| description | | |
| allowed-tools | Read, Write, Edit |
| version | 1.0.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
Vast.ai Hello World
Overview
Minimal working example demonstrating core Vast.ai functionality.
Prerequisites
- Completed
vastai-install-authsetup - Valid API credentials configured
- Development environment ready
Instructions
Step 1: Create Entry File
Create a new file for your hello world example.
Step 2: Import and Initialize Client
import { Vast.aiClient } from '@vastai/sdk';
const client = new Vast.aiClient({
apiKey: process.env.VASTAI_API_KEY,
});
Step 3: Make Your First API Call
async function main() {
// Your first API call here
}
main().catch(console.error);
Output
- Working code file with Vast.ai client initialization
- Successful API response confirming connection
- Console output showing:
Success! Your Vast.ai connection is working.
Error Handling
| Error | Cause | Solution |
|---|---|---|
| Import Error | SDK not installed | Verify with npm list or pip show |
| Auth Error | Invalid credentials | Check environment variable is set |
| Timeout | Network issues | Increase timeout or check connectivity |
| Rate Limit | Too many requests | Wait and retry with exponential backoff |
Examples
TypeScript Example
import { Vast.aiClient } from '@vastai/sdk';
const client = new Vast.aiClient({
apiKey: process.env.VASTAI_API_KEY,
});
async function main() {
// Your first API call here
}
main().catch(console.error);
Python Example
from vastai import Vast.aiClient
client = Vast.aiClient()
# Your first API call here
Resources
Next Steps
Proceed to vastai-local-dev-loop for development workflow setup.