kyozensys/phantompool repository overview

Minimal Chromium browser pool exposed via HTTP.

Runs real browsers, keeps them alive, and hands them out using leases. Built for control, not tricks.

Source: https://github.com/Kyozen-Sys/PhantomPool⁠

• Persistent pool of Chromium instances
• One browser per request (via lease)
• Hard cancellation on timeout or disconnect
• Bounded queue to avoid overload

⁠API

GET /navigate

Query:

• url (required)
• timeoutMS (optional)

Responses:

• 200 success
• 429 queue full
• 499 client aborted
• 5xx error

Returns HTML + status + headers (cookies, UA, etc).

⁠Env config

HOST=0.0.0.0
PORT=4000

BROWSER_POOL_SIZE=1
BROWSER_POOL_RETRYMS=3000

BROWSER_LEASE_TIMEOUTMS=30000

QUEUE_MAXJOBS=20
QUEUE_RETRYMS=100

⁠Docker

docker run -p 4000:4000 phantompool

Chromium is bundled.

• Built to be simple
• Built to be predictable
• Built to fail cleanly