ranno 0.3.2

Instant code generation & execution from prompts.

Ranno

Ranno is a Python Library 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 (Auto-Backup)

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 & model (Only Gemini models are supported)
my_config = cf(api_key="your_api_key", model="model_name")

# Run with custom config
gn("Plot Sine Wave", config=my_config)

# Execute 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
🧪 Instant Execution	Runs AI-generated Python code directly with automated error handling
⚙️ 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 & execution	Python, Magika, Pandas
2️⃣	Ranno API	Serverless backend for secure code generation	FastAPI, Vercel, Gemini

---

Made with 🦖 by Saptarshi Roy