ranno 0.4.0

Instant code generation & execution from prompts.

---

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.

🔗 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
print(gn("Create a list of 10 dinosaurs"))

# With Data
print(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 price vs category", data="data.csv")

Save Code to File (Write to Disk)

from ranno import gn, sv

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

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

Custom Configuration (API & Model)

from ranno import cf, gn, ex

# Set custom credentials & model (Gemini only)
my_cfg = cf(api_key="api_key", model="model_name")

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

# Execute with custom config
ex("Plot correlation", data="data.csv", config=my_cfg)

---

✨ 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	Four functions (gn, ex, sv, 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