@buildingopen/cli

Deploy Python functions as live web apps from the terminal.

Install

npm install -g @buildingopen/cli

Setup

export RUNIT_URL=http://localhost:3001   # your RunIt server
export RUNIT_API_KEY=your-api-key        # optional for OSS mode

Usage

Deploy

# Deploy a Python file
runit deploy my_script.py

# Deploy with a name
runit deploy my_script.py --name "Flight Finder"

# Deploy a ZIP with requirements.txt
runit deploy project.zip

Run

After deploying, run your app from the browser or use the client SDK.

Manage

runit list                        # List all apps
runit logs my-app                 # View recent run logs
runit open my-app                 # Open in browser
runit delete my-app               # Delete an app

# Versions
runit versions my-app             # List versions
runit promote my-app              # Promote dev to production
runit rollback <version_id>       # Rollback to a version

# API Keys (secrets)
runit secrets list my-app
runit secrets set my-app API_KEY sk-123
runit secrets delete my-app API_KEY

# Persistent storage
runit storage list my-app
runit storage get my-app counter
runit storage set my-app counter 42

# Share links
runit share create my-app
runit share list my-app

# Health check
runit doctor

Project Context

After deploying, the CLI saves project context to .runit/project.json. Subsequent commands auto-detect the app ID, so you can run runit logs without specifying an app name.

License

MIT