Skip to content

botswin/BotV8

Repository files navigation

BotV8

Profile-backed Web API runtime for browser privacy validation

Privacy • Consistency • Protection • Validation

Repository Releases Security License Website

BotV8 is a profile-backed Web API runtime for teams that need controlled JavaScript execution, browser-like API behavior, and local evidence about what web content can observe.

It follows the same product direction as BotBrowser: Privacy, Consistency, and Protection. BotV8 focuses on the Web API layer, where modern pages read browser APIs, timing behavior, storage surfaces, network context, and execution state.

Request Access

BotV8 runtime packages, SDK files, and approved profiles are provided through the BotBrowser support and enterprise channels.

When requesting access, include the target operating system, language SDK, expected profile family, and whether the package will be used with BotBrowser in the same validation workflow.

Licensed users receive a matched runtime package, SDK files, package notes, and profile material for the approved release line. Start with Requirements, then check SDK Access and Release Package Layout before running the examples.

Product Areas

  • Privacy audit: records browser signal families touched during an authorized test.
  • Web API runtime: provides browser-like API behavior for controlled page logic.
  • Runtime isolation: keeps execution scoped to profile-backed state and inputs.
  • API consistency: aligns exposed browser behavior with the selected profile family.
  • Request support: sends approved requests through BotV8-owned runtime, cookie, and network state.
  • Evidence: produces local reports for QA, support, and privacy release review.

Repository Contents

This repository contains product and technical material for BotV8.

Runtime source code, customer packages, private technical material, profiles, credentials, and live evidence are maintained outside this repository.

BotV8 And BotBrowser

BotBrowser protects a complete browser environment. BotV8 works closer to the Web API runtime layer.

Choose BotV8 when the work is about:

  • auditing browser-visible signals during page execution
  • validating profile-backed JavaScript behavior
  • running controlled code that expects browser-like Web APIs
  • checking consistency between runtime state and browser family
  • preparing evidence for privacy QA
  • supporting approved application flows that depend on page-generated browser context

Choose BotBrowser when the work needs a full browser binary, rendering stack, network stack, profiles, and automation control.

Use both when a project needs full-browser privacy validation and a runtime-level view of Web API behavior.

Typical BotV8 delivery includes the runtime shell, matching SDK files, approved profile material, example commands, and sanitized report guidance. A validation run should end with a local report that shows runtime state, network summary, cookie summary, and event summary without publishing private material.

Use Cases

  • browser privacy QA
  • browser-like Web API runtime
  • JavaScript signal audit
  • profile-backed runtime validation
  • browser API consistency review
  • controlled web execution
  • local release evidence

Run SDK Examples

export BOTV8_ENV_SHELL=/path/to/botv8_env_shell
export BOTV8_PROFILE=/path/to/profile.enc
export BOTV8_PYTHON_SDK_DIR=/path/to/sdk-directory

python3 examples/basic-runtime/basic_runtime.py --url https://example.com/
python3 examples/web-api-consistency/web_api_consistency.py
python3 examples/request-context/request_context_fetch.py --url https://example.com/

The examples use the supported SDK surface and do not include private profiles, credentials, customer traffic, or provider-specific request material.

Expected output:

{
  "ok": true,
  "page": {
    "status": 200
  },
  "networkSummary": {
    "firstUrlClass": "provided-url"
  },
  "report": {
    "schemaVersion": "botv8-env-report-v0"
  }
}

Resources

Support Channels

WebsiteDocumentation, guides, blogbotbrowser.io
EmailTechnical questions, access, supportsupport@botbrowser.io
TelegramCommunity support, quick questions@botbrowser_support

Review Responsible Use, Security, and Disclaimer before using BotV8 material.

About

Profile-backed Web API runtime for browser privacy validation.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Contributors