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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ranno-0.4.1.tar.gz.
File metadata
- Download URL: ranno-0.4.1.tar.gz
- Upload date:
- Size: 4.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6b1150ea29b45e89d0b349c56ced0d2d4542068ce97bcce0b9032668ded1acbf
|
|
| MD5 |
45f56c45b75f988191b75b9619c210b8
|
|
| BLAKE2b-256 |
00a0ba019e8e00bc0b2c93f692d58fae0fbff90e5473e4b419d5a0a73a2449cf
|
File details
Details for the file ranno-0.4.1-py3-none-any.whl.
File metadata
- Download URL: ranno-0.4.1-py3-none-any.whl
- Upload date:
- Size: 5.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e8d734561c43ad61e714f7fa66db370a15a03ed098be8a22b1ad825c612aa968
|
|
| MD5 |
3597f21e2a461e2e379aadb526c6029f
|
|
| BLAKE2b-256 |
94284ec6893581f944e65a1a4bb9d20568da99cd00c91577d65c02b496abcec1
|
