Nightona Ruby SDK

The official Ruby SDK for Nightona, a secure and elastic infrastructure for running AI-generated code. Nightona provides full composable computers — sandboxes — that you can manage programmatically using the Nightona SDK.

The SDK provides an interface for sandbox management, file system operations, Git operations, language server protocol support, process and code execution, and computer use. For more information, see the documentation.

Installation

Install the package using gem:

gem install nightona

Get API key

Generate an API key from the Nightona Dashboard ↗ to authenticate SDK requests and access Nightona services. For more information, see the API keys documentation.

Configuration

Configure the SDK using environment variables or by passing a configuration object:

• NIGHTONA_API_KEY: Your Nightona API key
• NIGHTONA_API_URL: The Nightona API URL
• NIGHTONA_TARGET: Your target region environment (e.g. us, eu)

require 'nightona'

# Initialize with environment variables
nightona = Nightona::Nightona.new

# Initialize with configuration object
config = Nightona::Config.new(
  api_key: 'YOUR_API_KEY',
  api_url: 'YOUR_API_URL',
  target: 'us'
)

Create a sandbox

Create a sandbox to run your code securely in an isolated environment.

require 'nightona'

config = Nightona::Config.new(api_key: 'YOUR_API_KEY')
nightona = Nightona::Nightona.new(config)
sandbox = nightona.create

Examples and guides

Nightona provides examples and guides for common sandbox operations, best practices, and a wide range of topics, from basic usage to advanced topics, showcasing various types of integrations between Nightona and other tools.

Create a sandbox with custom resources

Create a sandbox with custom resources (CPU, memory, disk).

require 'nightona'

nightona = Nightona::Nightona.new
sandbox = nightona.create(
    Nightona::CreateSandboxFromImageParams.new(
        image: Nightona::Image.debian_slim('3.12'),
        resources: Nightona::Resources.new(cpu: 2, memory: 4, disk: 8)
    )
)

Create an ephemeral sandbox

Create an ephemeral sandbox that is automatically deleted when stopped.

require 'nightona'

nightona = Nightona::Nightona.new
sandbox = nightona.create(
    Nightona::CreateSandboxFromSnapshotParams.new(ephemeral: true, auto_stop_interval: 5)
)

Create a sandbox from a snapshot

Create a sandbox from a snapshot.

require 'nightona'

nightona = Nightona::Nightona.new
sandbox = nightona.create(
    Nightona::CreateSandboxFromSnapshotParams.new(
        snapshot: 'my-snapshot-name'
    )
)

Execute commands

Execute commands in the sandbox.

# Execute any shell command
response = sandbox.process.exec(command: 'ls -la')
puts response.result

# Setting a working directory and a timeout
response = sandbox.process.exec(command: 'sleep 3', cwd: 'workspace/src', timeout: 5)
puts response.result

# Passing environment variables
response = sandbox.process.exec(
  command: 'echo $CUSTOM_SECRET',
  env: { 'CUSTOM_SECRET' => 'NIGHTONA' }
)
puts response.result

File operations

Upload, download, and search files in the sandbox.

# Upload a text file from string content
content = "Hello, World!"
sandbox.fs.upload_file(content, "tmp/hello.txt")

# Download and get file content
content = sandbox.fs.download_file("workspace/data/file.txt")
puts content

# Get file metadata
info = sandbox.fs.get_file_info("workspace/data/file.txt")
puts "Size: #{info.size} bytes"
puts "Modified: #{info.mod_time}"
puts "Mode: #{info.mode}"

Git operations

Clone, list branches, and add files to the sandbox.

# Basic clone
sandbox.git.clone(
  url: 'https://github.com/nightona-co/nightona.git',
  path: 'workspace/repo'
)

# List branches
response = sandbox.git.branches('workspace/repo')
puts "Branches: #{response.branches}"

# Add files
sandbox.git.add('workspace/repo', ['README.md'])

Language server protocol

Create and start a language server to get code completions, document symbols, and more.

# Create a language server
lsp_server = sandbox.create_lsp_server(
  language_id: Nightona::LspServer::Language::PYTHON,
  path_to_project: 'workspace/project'
)
lsp_server.start

# Notify server that a file is open
lsp_server.did_open('workspace/project/main.py')

# Get document symbols
symbols = lsp_server.document_symbols('workspace/project/main.py')

# Get completions
completions = lsp_server.completions(
  path: 'workspace/project/main.py',
  position: Nightona::LspServer::Position.new(line: 10, character: 15)
)