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
1 maintainer
Metadata
1 maintainer
Release files for ranno 0.4.1
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.4.1.tar.gz | 4.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ranno-0.4.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 9.7 kB
Release files / ranno-0.4.1.tar.gz
| Download URL | ranno-0.4.1.tar.gz |
|---|---|
| Size | 4.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6b1150ea29b45e89d0b349c56ced0d2d4542068ce97bcce0b9032668ded1acbf
|
|
BLAKE2b-256 checksum How to use checksums |
00a0ba019e8e00bc0b2c93f692d58fae0fbff90e5473e4b419d5a0a73a2449cf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / ranno-0.4.1-py3-none-any.whl
| Download URL | ranno-0.4.1-py3-none-any.whl |
|---|---|
| Size | 5.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e8d734561c43ad61e714f7fa66db370a15a03ed098be8a22b1ad825c612aa968
|
|
BLAKE2b-256 checksum How to use checksums |
94284ec6893581f944e65a1a4bb9d20568da99cd00c91577d65c02b496abcec1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
