nself ai-studio

Open a Cloudflare Tunnel so Google AI Studio can reach your local nSelf instance — without exposing it permanently to the internet.

Quick start

# Start the bridge on the default port (8080)
nself ai-studio bridge

# Start on a specific port with context disabled
nself ai-studio bridge --port 9090 --no-context

Synopsis

nself ai-studio bridge [FLAGS]

Description

Google AI Studio supports custom tool endpoints, but they must be reachable from the public internet. nself ai-studio bridge starts a temporary Cloudflare Tunnel (via cloudflared) that forwards HTTPS traffic from a random *.trycloudflare.com subdomain to your local nSelf API.

By default the bridge also injects nSelf project context (stack version, plugin list, env) into the AI Studio system prompt so the AI understands your deployment. Use --no-context to disable this if you only want a raw tunnel.

The tunnel closes when you press Ctrl+C or when the idle timeout expires. No persistent configuration is written to Cloudflare — each run generates a fresh ephemeral URL.

Subcommands

nself ai-studio bridge

The only subcommand. Starts the Cloudflare Tunnel bridge.

nself ai-studio bridge
# Tunnel URL: https://random-name.trycloudflare.com
# Paste this into Google AI Studio → Connections → Custom endpoint
# Press Ctrl+C to close

Flags

Examples

Standard bridge with context injection

nself ai-studio bridge
# Prints: https://abc123.trycloudflare.com
# Paste URL into AI Studio as your tool endpoint
# nSelf context automatically injected into system prompt

Bridge on a specific port, EU region

nself ai-studio bridge --port 9090 --region eu

Restrict to Google IP ranges only

nself ai-studio bridge --ip-allowlist "66.249.0.0/16,64.233.160.0/19"

Dry-run to see the cloudflared command

nself ai-studio bridge --dry-run
# Outputs: cloudflared tunnel --url http://localhost:8080 --region auto

Short-lived session with 60-second idle timeout

nself ai-studio bridge --idle-timeout 60

Prerequisites

• cloudflared must be installed: brew install cloudflare/cloudflare/cloudflared
• The nSelf AI plugin must be installed and running: nself plugin status ai

Environment variables

• NSELF_AI_STUDIO_PORT — default port to expose (overrides --port)
• CLOUDFLARED_BIN — path to the cloudflared binary if not in PATH

Exit codes

• 0 — tunnel closed cleanly (Ctrl+C or idle timeout)
• 1 — cloudflared not found or tunnel failed to start
• 2 — invalid arguments

Related

• nself ai — manage local models and Gemini pool
• nself plugin — install and manage plugins