ranno 0.1.3

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")

---

✨ 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
🛡️ Shadow Copy Integrity	Creates a hidden .back snapshot before execution; restores on failure
🦎 Ultra Minimalism	Two functions (gn, ex) 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