Obscura Python SDK

Playwright-like Python entry points for the Rust Obscura browser fork. The SDK uses Playwright's own Python objects and CDP client; it does not download Chromium.

Install from this directory with pip install -e .. On first use, the SDK downloads the matching release from h4ckf0r0day/obscura into its own obscura-python data directory. Set OBSCURA_REPOSITORY to use another repository, such as your own fork, when it has compatible release assets. Set OBSCURA_PYTHON_HOME to choose the local root. OBSCURA_EXECUTABLE, executable_path, or a binary on PATH can override that download.

The package also installs the obscura-python command, which forwards CLI arguments to the Rust executable:

pip install obscura-python
obscura-python fetch https://example.com --dump text

With uv, install it as a tool:

uv tool install obscura-python
obscura-python --version

Releases are published by GitHub Actions. Create a tag such as v0.1.0 after configuring the repository as a Trusted Publisher for the obscura-python project on PyPI; the workflow builds and uploads the wheel and source archive without storing a PyPI token in GitHub.

For a local checkout use uv tool install ./python, or add it to a project with uv add ./python. The first execution may require internet access to download the Rust browser binary; set OBSCURA_EXECUTABLE for offline use.

from obscura.async_api import async_playwright

async with async_playwright() as p:
    browser = await p.chromium.launch(proxy={"server": "http://127.0.0.1:8080"})
    page = await browser.new_page()
    await page.goto("https://example.com")
    print(await page.title())
    await browser.close()

Each launch chooses a free loopback port and starts an independent process. connect_over_cdp() connects to an external process and never terminates it. Obscura is headless only; unsupported launch options produce explicit errors.

Download files

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

Source Distribution

obscura_python-0.1.1.tar.gz (8.3 kB view details)

Uploaded Sep 13, 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.

obscura_python-0.1.1-py3-none-any.whl (9.2 kB view details)

Uploaded Sep 13, 2026 Python 3

File details

Details for the file obscura_python-0.1.1.tar.gz.

File metadata

Download URL: obscura_python-0.1.1.tar.gz
Upload date: Sep 13, 2026
Size: 8.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for obscura_python-0.1.1.tar.gz
Algorithm	Hash digest
SHA256	`ac1adeebdc64e9717f818cca99f75ab6c49756aae17bd31655b93c493d958414`
MD5	`77de3dccedc9dd327cf8bc5e1c242bed`
BLAKE2b-256	`0a99a9d27bd545cc6d36ef38c0966116a00e22aafeabc87bd2c162c5a5669522`

See more details on using hashes here.

Provenance

The following attestation bundles were made for obscura_python-0.1.1.tar.gz:

Publisher: publish.yml on Willianjesusdasilva/obscura-python

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: obscura_python-0.1.1.tar.gz
- Subject digest: ac1adeebdc64e9717f818cca99f75ab6c49756aae17bd31655b93c493d958414
- Sigstore transparency entry: 2822657453
- Sigstore integration time: Sep 13, 2026
Source repository:
- Permalink: Willianjesusdasilva/obscura-python@c6a123d1ef472fc97904e9cd1e0f3ccca2d420e6
- Branch / Tag: refs/tags/v0.1.1
- Owner: https://github.com/Willianjesusdasilva
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@c6a123d1ef472fc97904e9cd1e0f3ccca2d420e6
- Trigger Event: push