ranno 0.2.1

A minimalist AI-Bridge for instant code generation and sandboxed execution.

Ranno

Ranno is a minimalist AI-Bridge that turns plain English into executable Python - instantly. Just describe what you want, and Ranno generates, understands your data, and runs the code for you.

🔗 PyPI Package  |  🆔 pip install ranno or uv add ranno

---

🐍 SDK

Installation

pip install ranno
# or
uv add ranno

Generate Code (No Execution)

from ranno import gn

# Without Data
gn("Create a list of 10 dinosaurs and print it")

# With Data
gn("Find the average price", data="data.csv")

Execute Code Instantly (Sandboxed)

from ranno import ex

# Without Data
ex("Print hello world 5 times")

# With Data
ex("Plot the correlation between price and category", data="data.csv")

Custom Configuration (API & Model)

from ranno import cf, gn, ex

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

# Run with custom config
gn("Explain quantum physics", config=my_config)

# Excute with custom config
ex("Plot the correlation between price and category", data="data.csv", config=my_config)

---

✨ Features

FEATURE	DESCRIPTION
🧠 AI Code Generation	Turns plain English prompts into full, runnable Python scripts
🔍 AI File Intelligence	Detects file types (CSV, Excel, JSON) accurately, even without extensions
📊 Auto Schema Extraction	Reads columns and first 5 rows to build perfect AI context automatically
🧪 Sandboxed Execution	Runs AI code in an isolated environment with pd, np pre-loaded
⚙️ Custom Configuration	Override default API keys and Models per request using cf()
🛡️ Shadow Copy Integrity	Creates a hidden copy. snapshot before execution; restores on failure
🦎 Ultra Minimalism	Three functions (gn, ex, cf) is all you need - zero boilerplate

---

🏗️ System Architecture

#	COMPONENT	DESCRIPTION	STACK
1️⃣	Ranno SDK	The client-side library handling data prep and execution	Python, Pandas, Magika
2️⃣	AI Bridge API	Serverless backend for secure code generation	FastAPI, Vercel, Gemini 3.1

---

Made with 🦖 by Saptarshi Roy