gradipin 0.1.2

Static URLs for your Gradio demos. One line of code.

Gradipin

Static URLs for your Gradio demos. One line of code.

Gradio's share=True gives you a public URL that changes every time you restart your demo. Gradipin sits in front of those tunnels and gives you a stable link like https://gradipin.lovable.app/go/<account>/<app> that always points to whichever tunnel is currently live — perfect for tweets, READMEs, and your team's "demos" channel.

import gradio as gr
import gradipin

demo = gr.Interface(lambda x: x.upper(), "text", "text")
gradipin.share(demo, app="vision-model")
# Prints something like:
#   Gradipin: https://gradipin.lovable.app/go/your-account/vision-model
#     → https://abc123.gradio.live

The exact URL format depends on your Gradipin deployment — the canonical public URL is returned by the API and is also exposed as session.public_url if you need it programmatically.

That's it. Restart the script, get a new tunnel, your friends still hit the same URL.

Install

pip install gradipin[gradio]

If you're not using Gradio (e.g. you have your own ngrok / cloudflared tunnel in front of a FastAPI app), the base install is enough:

pip install gradipin

Authenticate

Grab an API key from gradipin.lovable.app/dashboard, then either:

gradipin login           # saves to ~/.gradipin/config

or set the environment variable:

export GRADIPIN_KEY=gp_live_...

or pass it explicitly:

gradipin.share(demo, app="vision-model", key="gp_live_...")

Lower-level API

Have your own public URL? Use the context manager:

import gradipin

with gradipin.session("my-api", url="https://abc.ngrok.io"):
    run_my_fastapi_server()

CLI

gradipin login            # save your API key
gradipin logout           # forget your API key
gradipin list             # list your apps and their status
gradipin status <app>     # check whether a specific app is live

Configuration precedence

API key resolution (first match wins):

1. Explicit key=... argument
2. GRADIPIN_KEY environment variable
3. ~/.gradipin/config (written by gradipin login)
4. GRADIPIN_KEY in a .env file in the current working directory

Other environment variables:

• GRADIPIN_API_URL — override the API base URL (default https://gradipin.lovable.app/api/v1). Useful for self-hosted backends or local development.
• GRADIPIN_HEARTBEAT — heartbeat interval in seconds (default 30).

Development

git clone https://github.com/gradipin/gradipin-python
cd gradipin-python
uv sync --extra dev --extra gradio
uv run pytest

License

MIT