Install

npm i -g @mocasus/redrock

After install, redrock is available globally:

redrock                 # show banner
redrock --help          # list commands
redrock init my-bot     # scaffold a bot

Quick Start

redrock init my-bot -t YOUR_BOT_TOKEN
cd my-bot
vercel login
redrock deploy

Done. Open Telegram, send /start to your bot.

Commands

| Command | | |---------|---| | redrock init <name> -t <token> | scaffold a new bot | | redrock deploy | push to Vercel + register webhook | | redrock logs --follow | stream live request logs | | redrock db init | setup Vercel KV database | | redrock db migrate --to <provider> | switch database | | redrock switch <webhook\|polling> | toggle update mode |

Features

• 60-second deploy — scaffold → live webhook. One flow.
• $0 cost — Vercel free tier: 100GB bandwidth, scales to zero
• Python stdlib — generated bot uses zero pip dependencies
• Built-in DB — Vercel KV, Supabase, Firebase via redrock db init
• Live logs — redrock logs --follow streams in real-time

Database

redrock db init

Provisions Vercel KV + generates api/db.py:

from api.db import db
db.set("visits", 42)
count = db.get("visits")  # → 42

| Provider | Free Tier | |----------|-----------| | Vercel KV | 256 MB | | Supabase | 500 MB PostgreSQL | | Firebase | 1 GB Firestore |

VPS vs Redrock

| | VPS | Redrock | |---|---|---| | Price | $6+/mo | $0 | | Setup | 30-60 min | 60 sec | | Maintenance | OS, nginx, certs | None |

Docs

• Setup Guide
• ▶️ Demo video