gologin-api-wrapper (local GoLogin API wrapper)

This is a small local companion you run on your own machine to launch GoLogin profiles locally.

The hosted web app (e.g. Vercel) cannot launch local browsers, so it talks to this runner over http://127.0.0.1.

Prerequisites

• Node.js 20.x installed
• A GoLogin API token

Install (recommended)

npm i -g gologin-api-wrapper

1. Create a .env file (or export env vars in your shell):

export GOLOGIN_TOKEN="..."

Optional (recommended): restrict which web origins can call the localhost API:

export ALLOWED_ORIGINS="https://app.flygen.in,http://localhost:3001"

If you want a fully automated install + autostart (recommended), use the scripts in runner/scripts/.

See runner/INSTALL.md.

Run

gologin-api-wrapper start --port 17327

Health check:

curl http://127.0.0.1:17327/health

Open a GoLogin profile (launches a local headful Orbita):

curl -X POST http://127.0.0.1:17327/gologin/open \
  -H 'Content-Type: application/json' \
  -d '{"profileId":"YOUR_PROFILE_ID"}'

API

• GET /health
• POST /gologin/open { profileId } -> { profileId, wsEndpoint }