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.2.tar.gz (34.1 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.2-py3-none-any.whl (30.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: hvbrowser-0.1.2.tar.gz
  • Upload date:
  • Size: 34.1 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.2.tar.gz
Algorithm Hash digest
SHA256 572954b02ff6d597c50bec9eb955f526322c4a2e765d36b3a481ed27309eaa47
MD5 da27ad78b37dfb22612d348e1a247f7c
BLAKE2b-256 50dd3f98c42fcc1bf9e6a27557717c6b6840b50f30829627bd6ddedeeeeff074

See more details on using hashes here.

Provenance

The following attestation bundles were made for hvbrowser-0.1.2.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.2-py3-none-any.whl.

File metadata

  • Download URL: hvbrowser-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 30.2 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 0fb70863f41850361a8b57c911ddd5ce9962c7098b98924e635b51fd8ff7c80d
MD5 7846dee6b59f35f5469640a5aff3528c
BLAKE2b-256 b7a790fe1246ac26fd6e1e719a42199dd0c7a852f297ed6305d3861a5a4c7d3c

See more details on using hashes here.

Provenance

The following attestation bundles were made for hvbrowser-0.1.2-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

0.1.3

2 files

This release

0.1.2 This release

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