Vibe Automation SDK
Usage
ActIO subtask model
Use VA_ENABLE_SUBTASK_AGENT flag to enable all page.act calls to use ActIO model.
The support for page.step is coming later.
VA_ENABLE_SUBTASK_AGENT=true uv run python examples/act.py
Development Setup
Prerequisites
- Python >=3.13
- uv package manager
Installation
-
Install uv if you haven't already:
curl -LsSf https://astral.sh/uv/install.sh | sh
-
Install dependencies:
uv sync -
Activate the virtual environment:
source .venv/bin/activate
-
Add protos for
orby/va/public:
uv run python -m scripts.generate_protos
Running Examples
uv run python examples/form.py
Version Management & Releases
Use the release script for a streamlined release process:
# Test what would happen (dry-run)
./release.sh patch --dry-run
# Create a patch release (bug fixes)
./release.sh patch
# Create a minor release (new features, backward compatible)
./release.sh minor
# Create a major release (breaking changes)
./release.sh major
The release script automatically:
- Ensures you're on the main branch with latest changes
- Bumps version in all files (
pyproject.toml,.bumpversion.toml) - Creates a git commit with the version change
- Creates a release branch (
release/v{version}) - Creates a pull request
Release Workflow
The release process kicks off when the previous PR is merged. A first GitHub action creates a tag (release/v{version}) which in turn triggers a second Github action to:
- Creates a GitHub release with auto-generated release notes
- Builds the package using
uv build - Publishes to PyPI using OpenID Connect (trusted publishing)
1 maintainer
Metadata
1 maintainer
Release files for vibe-automation 0.11.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| vibe_automation-0.11.0.tar.gz | 125.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| vibe_automation-0.11.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 281.9 kB
Release files / vibe_automation-0.11.0.tar.gz
| Download URL | vibe_automation-0.11.0.tar.gz |
|---|---|
| Size | 125.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
df9f447d3d8ba93e367b0175ad3dc3a44192f11e2e223801c79ff96df58207d5
|
|
BLAKE2b-256 checksum How to use checksums |
acf4b5f4f99ed4f7f212db87d0ec7a02a2aff3e379794689574d482c9e8740e9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 16, 2025.
Transparency logRelease files / vibe_automation-0.11.0-py3-none-any.whl
| Download URL | vibe_automation-0.11.0-py3-none-any.whl |
|---|---|
| Size | 156.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0365c4e9c198202ac457e87965207e8d34db8717f0f2105e76163ce345a6f67a
|
|
BLAKE2b-256 checksum How to use checksums |
f8f2e4c550b1342d39cfa088659a32e91a715149234e869254251838aedb5bc1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 16, 2025.
Transparency log
