title: Ranno emoji: 🦖 colorFrom: gray colorTo: yellow sdk: docker pinned: false app_port: 7860
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
gn("Create a list of 10 dinosaurs")
# 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 price vs category", data="data.csv")
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
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 | 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
1 maintainer
Metadata
1 maintainer
Release files for ranno 0.3.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ranno-0.3.3.tar.gz | 4.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ranno-0.3.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 8.4 kB
Release files / ranno-0.3.3.tar.gz
| Download URL | ranno-0.3.3.tar.gz |
|---|---|
| Size | 4.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
695649ee0cdc2f49f82c6307dc77abffb65d599317955df0645c8b56d5de8867
|
|
BLAKE2b-256 checksum How to use checksums |
ca1a8842621430706e0c74691a4abcef760f26705ef30cc5615ff5dc2750eb1c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.13
|
Release files / ranno-0.3.3-py3-none-any.whl
| Download URL | ranno-0.3.3-py3-none-any.whl |
|---|---|
| Size | 4.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
24906c5b64b7d4261527ca5f3b22ce4527bc358a4b21e6a84ed4572c6e41dadf
|
|
BLAKE2b-256 checksum How to use checksums |
9833cb4a173533a43a4401242ba213a5d10e4178fd2cff714012c1ac62d1fad9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.13
|
