HVBrowser

HVBrowser provides browser automation APIs for HentaiVerse. It builds on hbrowser for the shared authenticated browser session.

The package was extracted from the historical combined hbrowser distribution. Battle-domain APIs live in the separate hvbattle package.

Lottery and Monster Lab APIs

Lottery inspection is read-only and returns the current ticket count, shared GP balance, and the fixed 1,000 GP ticket price. Purchasing requires an explicit lottery kind and positive quantity, then verifies the exact ticket increase and GP decrease before returning:

from hvbrowser import LotteryClient, LotteryKind

client = LotteryClient(driver)
snapshot = await client.inspect(LotteryKind.WEAPON)
report = await client.purchase(
    LotteryKind.WEAPON,
    25,
    expected_before=snapshot,
)

The optional snapshot is an optimistic precondition: if tickets, GP, lottery kind, or price changed after planning, the client raises before touching the purchase form.

Target counts, Weapon-versus-Armor priority, and behavior when GP is limited are application policy and intentionally do not belong in this package. The legacy HVDriver.loetterycheck() spelling remains as a compatibility wrapper.

Monster Lab exposes the two known feed-all resources explicitly:

from hvbrowser import MonsterLabClient, MonsterLabFeed

client = MonsterLabClient(driver)
snapshot = await client.inspect()
food_report = await client.feed_all(MonsterLabFeed.FOOD)
drugs_report = await client.feed_all(MonsterLabFeed.DRUGS)

After the Monster Lab API is confirmed, an action image that is not present is reported as unavailable and produces no mutation. The selector and post-submission disappearance semantics still require a read-only live selector check and a separately authorized mutation check, respectively. Missing page structure, unknown submission outcomes, and unstable/failed post-submit confirmation raise typed errors. Both purchase and feed-all calls change account state; automated package tests use only offline fakes.

Development

Build a clean environment backed by the PyPI release of hbrowser:

bash scripts/rebuild-env.sh

For coordinated local development, overlay the clean environment manually:

uv pip install --python .venv/bin/python --reinstall --no-deps --editable \
  /Users/kuanlun_wang/Desktop/git-repo/hbrowser.clone

Commands that must preserve this editable overlay use uv run --no-sync.

Read-only Market inspection

Market inspection and sale planning are non-mutating by default:

import asyncio

from hvbrowser import HVDriver, SellItems


async def main() -> None:
    async with HVDriver(headless=True) as driver:
        snapshot = await driver.inspect_market()
        plan = await driver.marketcheck(SellItems(materials=["Low-Grade Metals"]))
        print(len(snapshot.items), plan.total_units)


asyncio.run(main())

The compatibility marketcheck() call requires commit=True before it can request submission. Submission is currently blocked by a fail-closed runtime gate until the current quote selector and pricing semantics have been confirmed with the read-only live probe. The guarded implementation never deposits credits and never re-lists unrelated orders.

Guarded live smoke test

The surrounding hentaiverse workspace owns account selection. This smoke probe only refuses to construct a browser unless credentials are supplied indirectly through the environment. It stops when an active battle is detected and contains no state-changing purchase, feed-all, submit, repair, recovery, or battle call. It does use navigation clicks to reach the requested read-only pages:

uv run --no-sync python scripts/live_readonly_smoke.py \
  --skip-market \
  --inspect-lotteries \
  --inspect-monster-lab

--skip-market lets the two new selectors be checked independently while the Market integration is unavailable. The last two flags only inspect counts and action availability. They never call the Lottery purchase form or do_feed_all.

Project links

Data verified by PyPI on Aug 2, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.10.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for kuan-lun from gravatar.com kuan-lun

Credits

Author: Kuan-Lun Wang

GitHub Statistics

Data verified by PyPI on Aug 2, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

AGPL-3.0-or-later
View SPDX License List

Requires

Python <3.15, >=3.14

Provides Extra

dev

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hvbrowser-0.1.3.tar.gz (34.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

hvbrowser-0.1.3-py3-none-any.whl (30.5 kB view details)

Uploaded Python 3

File details

Details for the file hvbrowser-0.1.3.tar.gz.

File metadata

  • Download URL: hvbrowser-0.1.3.tar.gz
  • Upload date:
  • Size: 34.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for hvbrowser-0.1.3.tar.gz
Algorithm Hash digest
SHA256 8a806d6c9da9fbdfd5b39a8f6e2235c627efe26cbbb52033a95e0ae977d66b53
MD5 e8699271d0bcf18e6ed55e36255952d0
BLAKE2b-256 cdd6865d00e8099424a8f215d8f242381479fcf4ab4679c639221292bcae226e

See more details on using hashes here.

Provenance

The following attestation bundles were made for hvbrowser-0.1.3.tar.gz:

Publisher: publish.yml on Kuan-Lun/hvbrowser

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file hvbrowser-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: hvbrowser-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 30.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for hvbrowser-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 b298ad81f16cf553e86baa518ea8f65e86ef6740e65a62e425b1cf95ec1d7b79
MD5 f1680dcda5fe0416e47c4af58c94b0de
BLAKE2b-256 5d2177a8e79dd1e34c79397ef54b9dbf939453d12e9ac758968c07347d51c329

See more details on using hashes here.

Provenance

The following attestation bundles were made for hvbrowser-0.1.3-py3-none-any.whl:

Publisher: publish.yml on Kuan-Lun/hvbrowser

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.10.2

2 files

0.10.1

2 files

0.9.8

2 files

0.9.7

2 files

0.9.6

2 files

0.9.5

2 files

0.9.4

2 files

0.9.3

2 files

0.9.2

2 files

0.9.1

2 files

0.8.0

2 files

0.7.3

2 files

0.7.2

2 files

0.7.0

2 files

0.6.1

2 files

0.5.0

2 files

0.4.0

2 files

0.3.0

2 files

0.2.13

2 files

0.2.12

2 files

0.2.11

2 files

0.2.10

2 files

0.2.9

2 files

0.2.8

2 files

0.2.7

2 files

0.2.6

2 files

0.2.5

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

This release

0.1.3 This release

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page