Installation

Vibengine provides an SDK for programmatic sandbox management and a CLI for local development workflows.

SDK Installation

npm install vibengine

import { Sandbox } from 'vibengine'

pip install vibengine

from vibengine import Sandbox

CLI Installation

The CLI is used to manage templates, authenticate, and interact with sandboxes from the terminal.

npm install -g @vibengine/cli

Verify the installation:

ve --version

Authentication

Set your API key

Get your API key from the Vibengine Dashboard and set it as an environment variable:

export VE_API_KEY=your_api_key_here

For persistent configuration, add it to your shell profile (~/.bashrc, ~/.zshrc, etc.):

echo 'export VE_API_KEY=your_api_key_here' >> ~/.bashrc

CLI Authentication

You can also authenticate the CLI interactively:

ve auth login

This opens a browser window to authenticate with your Vibengine account.

Verify Setup

import { Sandbox } from 'vibengine'

const sandbox = await Sandbox.create()
const result = await sandbox.commands.run('echo "Setup complete!"')
console.log(result.stdout) // "Setup complete!"
await sandbox.kill()

from vibengine import Sandbox

sandbox = Sandbox()
result = sandbox.commands.run('echo "Setup complete!"')
print(result.stdout)  # "Setup complete!"
sandbox.kill()