Scriptling Scriptling

Quick Start

Get up and running with Scriptling in minutes.

CLI Installation

Install the Scriptling CLI to run scripts from the command line.

Homebrew (macOS & Linux)

brew install paularlott/tap/scriptling

GitHub Releases

Download pre-built binaries from GitHub Releases:

  • Linux (AMD64, ARM64)
  • macOS (AMD64, ARM64)
  • Windows (AMD64, ARM64)

Go Install

If you have Go installed:

go install github.com/paularlott/scriptling/scriptling-cli@latest

Build from Source

# Clone the repository
git clone https://github.com/paularlott/scriptling.git
cd scriptling

# Build CLI for current platform
make build
# or use Task: task build

# Run scripts
./bin/scriptling script.py

CLI Quick Start

Run a Script

scriptling script.py

Interactive Mode

scriptling --interactive

Pipe Script

echo 'print("Hello")' | scriptling

HTTP Server

scriptling --server :8000 script.py

MCP Server

scriptling --server :8000 --mcp-tools ./tools script.py

Go Embedding

For embedding Scriptling in Go applications:

go get github.com/paularlott/scriptling

Hello World

package main

import (
    "fmt"
    "github.com/paularlott/scriptling"
    "github.com/paularlott/scriptling/stdlib"
)

func main() {
    // Create interpreter
    p := scriptling.New()

    // Register standard libraries
    stdlib.RegisterAll(p)

    // Execute Scriptling code
    result, err := p.Eval(`
print("Hello, World!")
`)
    if err != nil {
        fmt.Println("Error:", err)
    }
}

Variables and Functions

p := scriptling.New()
stdlib.RegisterAll(p)

result, err := p.Eval(`
# Variables
x = 42
name = "Alice"
numbers = [1, 2, 3]

# Functions
def greet(n):
    return "Hello " + n

# Output
print(greet(name))
print("Sum:", x + len(numbers))
`)

Variable Exchange

// Set variables from Go
p.SetVar("api_base", "https://api.example.com")
p.SetVar("timeout", 30)

// Execute script
p.Eval(`
response = requests.get(api_base + "/users", {"timeout": timeout})
data = json.loads(response.body)
result = len(data)
`)

// Get variables back
count, _ := p.GetVarAsInt("result")
fmt.Printf("Found %d users\n", count)

Next Steps