Fallbakit Tunnel

Go Binary

Run the Fallbakit tunnel agent directly as a Go binary.

Build or run

go run ./cmd/fallbakit-agent --help

Or build a binary:

go build -o fallbakit-agent ./cmd/fallbakit-agent

Ollama example

export FALLBAKIT_RUNNER_ID=runner_from_dashboard
export FALLBAKIT_RUNNER_API_KEY=rr_from_dashboard
export FALLBAKIT_BASE_URL=https://api.fallbakit.com
export FALLBAKIT_LOCAL_PROVIDER=ollama
export FALLBAKIT_LOCAL_BASE_URL=http://localhost:11434

./fallbakit-agent -metrics-addr=:9093

oMLX example

export FALLBAKIT_RUNNER_ID=runner_from_dashboard
export FALLBAKIT_RUNNER_API_KEY=rr_from_dashboard
export FALLBAKIT_BASE_URL=https://api.fallbakit.com
export FALLBAKIT_LOCAL_PROVIDER=omlx
export FALLBAKIT_LOCAL_BASE_URL=http://localhost:8000

./fallbakit-agent -metrics-addr=:9093

vLLM example

export FALLBAKIT_RUNNER_ID=runner_from_dashboard
export FALLBAKIT_RUNNER_API_KEY=rr_from_dashboard
export FALLBAKIT_BASE_URL=https://api.fallbakit.com
export FALLBAKIT_LOCAL_PROVIDER=vllm
export FALLBAKIT_LOCAL_BASE_URL=http://localhost:8000
export FALLBAKIT_LOCAL_API_KEY=optional_vllm_api_key

./fallbakit-agent -metrics-addr=:9093

Use http://localhost:8000 for the agent base URL. Direct OpenAI clients use http://localhost:8000/v1, but the agent should not include /v1.

YAML config

api_key: "rr_from_dashboard"
base_url: "https://api.fallbakit.com"
local_provider: "ollama"
local_base_url: "http://localhost:11434"
local_api_key: ""
runner_id: "runner_from_dashboard"
metrics_addr: ":9093"
local_timeout: "3s"

Run it with:

./fallbakit-agent -config ./agent.yaml

Compatibility note

FALLBAKIT_OLLAMA_URL and ollama_url remain available as backward-compatible aliases only for Ollama. New setups should prefer FALLBAKIT_LOCAL_BASE_URL and local_base_url, plus FALLBAKIT_LOCAL_TIMEOUT or local_timeout for readiness probes.

Go Binary | Fallbakit Docs | Fallbakit