title: Ranno emoji: 🦖 colorFrom: gray colorTo: yellow sdk: docker pinned: false app_port: 7860 short_description: Python Library

Ranno

Ranno is a lightweight Python Library that converts prompts into fully-functional Python scripts, scans dataset columns automatically, and runs code safely with automated rollback file protection.

✳️ SDK

Installation

pip install ranno
# or
uv add ranno

Generate Code (gn)

from ranno import gn

# Generate code silently
code = gn("Create a list of 10 dinosaurs")
print(code)

# Generate code with dataset context
dataset_code = gn("Find the average salary", data="employees.csv")
print(dataset_code)

Execute Code (ex)

from ranno import ex

# Execute prompt instantly
ex("print('Hello from Ranno execution context')")

# Execute tasks with dataset context
ex("Plot salary vs department", data="employees.csv")

Explain Code & Scripts (xp)

from ranno import xp

# Explain prompt directly
explanation = xp("Explain how quicksort works in Python")
print(explanation)

# Explain local .py script file
file_explanation = xp("Explain this code", data="script.py")
print(file_explanation)

Save Code to File (sv)

from ranno import gn, sv

# Generate code silently
code = gn("Download image from URL")

# Save it to a file
sv(code, name="file.py")

Custom Configuration (cf)

from ranno import gn, ex, xp, cf

# Configure custom credentials and model
my_config = cf(api_key="api_key", model="model_name")

# Run generation with custom config
print(gn("Plot a sine wave", config=my_config))

# Run execution with custom config
ex("Plot correlation heatmap", data="data.csv", config=my_config)

# Run explanation with custom config
print(xp("Explain decorators", config=my_config))

✳️ Features

✳️ Architecture

Made with 🦖 by Saptarshi Roy