HVBattle

HVBattle provides reusable HentaiVerse battle-domain APIs. It builds on hvbrowser for the authenticated Hentaiverse browser session and keeps the private command-line runner in a separate application workspace.

The first release preserves the historical BattleDriver API while adding a safe run_current() boundary. That method only runs an already active battle; it never repairs equipment, recovers stamina, or starts Arena/GrindFest. Automatic next-battle toggles default to off and require explicit opt-in. BattleDriver preloads the PonyChart classifier and ONNX model before opening the browser, so a timed challenge never pays the first-load cost.

import asyncio

from hvbattle import BattleDriver


async def main() -> None:
    async with BattleDriver(headless=True) as driver:
        await driver.run_current()


asyncio.run(main())

The legacy battle() loop remains available for the private runner. It can repair equipment and recover stamina; starting another Arena or GrindFest also requires explicitly enabling the corresponding auto-next option.

Development

Build a clean environment backed by PyPI releases:

bash scripts/rebuild-env.sh

For coordinated local development before all dependent releases are on PyPI, overlay editable checkouts in dependency order:

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

Commands that must preserve these editable overlays use uv run --no-sync.

Download files

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

Source Distribution

hvbattle-0.1.0.tar.gz (22.7 kB view details)

Uploaded Aug 2, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

hvbattle-0.1.0-py3-none-any.whl (23.3 kB view details)

Uploaded Aug 2, 2026 Python 3

File details

Details for the file hvbattle-0.1.0.tar.gz.

File metadata

Download URL: hvbattle-0.1.0.tar.gz
Upload date: Aug 2, 2026
Size: 22.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for hvbattle-0.1.0.tar.gz
Algorithm	Hash digest
SHA256	`98454d7db85e55deeb4d49a724a393763c6bc5619ad9c1b8a6ba3e7d4894778d`
MD5	`b162475044dca69f39cdaa1adad540cd`
BLAKE2b-256	`a3f2140b9a36cf8205274ccf8cc4c019262d5d88e362a712360f0dfe023793cd`

See more details on using hashes here.

Provenance

The following attestation bundles were made for hvbattle-0.1.0.tar.gz:

Publisher: publish.yml on Kuan-Lun/hvbattle

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: hvbattle-0.1.0.tar.gz
- Subject digest: 98454d7db85e55deeb4d49a724a393763c6bc5619ad9c1b8a6ba3e7d4894778d
- Sigstore transparency entry: 2323151898
- Sigstore integration time: Aug 2, 2026
Source repository:
- Permalink: Kuan-Lun/hvbattle@a74ec66fe5fdb5d14bbf294bddcd7fd24c4b6667
- Branch / Tag: refs/heads/main
- Owner: https://github.com/Kuan-Lun
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@a74ec66fe5fdb5d14bbf294bddcd7fd24c4b6667
- Trigger Event: push