Hidemium

Hidemium is an anti-detect browser with API support. The SDK provides a built-in adapter.

Setup


import {
  AntidetectBaseFlow, AntidetectProvider,
  FlowLogger, IScriptContext,
} from '@hira-core/sdk'
 
export default class MyFlow extends AntidetectBaseFlow<typeof config> {
  constructor(provider: AntidetectProvider = AntidetectProvider.HIDEMIUM) {
    super(provider, new FlowLogger('MyFlow'), config)
  }
}

Hidemium must be running locally. Default API: http://127.0.0.1:2222

How it works

SDK calls Hidemium API to start a profile
Hidemium returns a WebSocket debugger URL
SDK connects via Puppeteer using the WebSocket URL
When done, SDK calls Hidemium API to close the profile

Hidemium API Endpoints Used

Action	Endpoint
List profiles	`GET /api/v2/profile/get-all-profile`
Start profile	`POST /api/v2/profile/start`
Close profile	`POST /api/v2/profile/close`

Example 1 — Basic Hidemium flow


export default class HidemiumFlow extends AntidetectBaseFlow<typeof config> {
  constructor(provider: AntidetectProvider = AntidetectProvider.HIDEMIUM) {
    super(provider, new FlowLogger('HidemiumFlow'), config)
  }
 
  async script(context: IScriptContext<typeof config>) {
    const browser = new BrowserUtils(context)
 
    context.logger.info(`Profile: ${context.profile.name}`)
    context.logger.info(`ID: ${context.profile.id}`)
 
    await browser.goto('https://example.com')
    // ... your automation
  }
}

Custom API URL

If Hidemium is running on a different port, set the environment variable in .env:


HIDEMIUM_API_URL=http://127.0.0.1:3333

Available Providers

The SDK supports multiple anti-detect browsers via AntidetectProvider:


enum AntidetectProvider {
  GPM = 'gpm',           // GPM Login — default: http://127.0.0.1:19995
  HIDEMIUM = 'hidemium', // Hidemium  — default: http://127.0.0.1:2222
  GENLOGIN = 'genlogin', // GenLogin
  ADSPOWER = 'adspower', // AdsPower
}

Profile mapping

The SDK normalizes Hidemium’s native profile format to IAntidetectProfile:

Hidemium field	SDK field
`uuid`	`id`
`name`	`name`
`proxy`	`raw_proxy`
`browserVersion`	`browser_version`
`profilePath`	`profile_path`