Pre-release

This release is a pre-release and may not be stable for production use.

NodeMantis Python

The NodeMantis Python SDK: browser-driving agent sessions at parity with the npm node-mantis package, plus configuration, browser setup, and installation validation tools.

Platform wheels bundle the same compiled native runtime the npm SDK uses; the Python layer is a thin client that spawns it and forwards requests. Browser sessions additionally need Playwright for Python (the [browser] extra) — the runtime launches and drives a real Google Chrome through it.

Customer install:

pip install "node-mantis[browser]"
python -m nodemantis configure --api-key "$NODEMANTIS_API_KEY"
python -m nodemantis install-browser --browser chrome
python -m nodemantis smoke

Run a browser goal:

from nodemantis import NodeMantis

with NodeMantis.start(start_url="https://example.com", headless=True) as mantis:
    result = mantis.run("Open the More information link.", max_iterations=5)
    print(result.ok, result.reason)

The session surface mirrors the TypeScript SDK: NodeMantis.start() / NodeMantis.preflight(), and per-session go, run, step, retrieve, extract, check, close (sessions are context managers). Options are snake_case (max_iterations, screenshot_enabled, result_schema, allow_navigation, …); model selects a size tier ("small", "standard", "large"). run/step accept an on_progress callback for per-iteration narration; callbacks arrive on a background thread and must not call session methods. retrieve returns a discriminated result (status of success, not_found, or error, with data, contributor_ids, warnings, tokens, final_url). Schemas are plain JSON Schema dicts (pydantic v2 model classes are also accepted). attach() and context_options are TypeScript-only.

API keys resolve from the api_key argument, then NODEMANTIS_API_KEY, NODEMANTIS_AUTH_TOKEN, and finally the nodemantis configure config file. The package always connects to the hosted Node Mantis API; the service endpoint is not customer-configurable.

node-mantis[browser] installs Playwright for browser sessions, checks, and smoke tests. Browser binaries are installed separately; run python -m nodemantis install-browser --browser chrome for Google Chrome or use --browser chromium for Playwright Chromium.

Installing the wheel also puts a nodemantis command on PATH (equivalent to python -m nodemantis); pipx install node-mantis gives the same command in an isolated environment. This CLI covers setup verbs only — configure, doctor, install-browser, smoke. Command-line task execution (nodemantis run, nodemantis retrieve) ships with the npm package: npm install -g node-mantis. If both are installed, whichever is first on PATH wins; the setup verbs behave identically.

Validate API access, credentials, and the selected browser from Python:

from nodemantis import preflight

report = preflight(check_browser_launch=True, timeout_seconds=5)
if not report.ok:
    raise RuntimeError(report.checks)

Supported alpha platforms: Linux x64, Windows x64, macOS x64, and macOS arm64. Wheels without a bundled runtime (source-free builds) raise RUNTIME_NOT_INSTALLED when starting a session; advanced setups can point NODEMANTIS_RUNTIME_PATH at a runtime executable.

This package is proprietary alpha software. Use is governed by LICENSE.txt and applicable NodeMantis terms.

Project links

Data verified by PyPI on Aug 4, 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.1.0a16)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for zuyanton from gravatar.com zuyanton

Credits

Author: NodeMantis

GitHub Statistics

Data verified by PyPI on Aug 4, 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

LicenseRef-NodeMantis-Proprietary
View SPDX License List

Requires

Python >=3.9

Provides Extra

browser

Tags

browser automation playwright node-mantis nodemantis

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 Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

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

node_mantis-0.1.0a10-py3-none-win_amd64.whl (2.7 MB view details)

Uploaded Python 3Windows x86-64

node_mantis-0.1.0a10-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.8 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ x86-64

node_mantis-0.1.0a10-py3-none-macosx_11_0_arm64.whl (2.4 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

node_mantis-0.1.0a10-py3-none-macosx_10_12_x86_64.whl (2.7 MB view details)

Uploaded Python 3macOS 10.12+ x86-64

File details

Details for the file node_mantis-0.1.0a10-py3-none-win_amd64.whl.

File metadata

File hashes

Hashes for node_mantis-0.1.0a10-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 f998b70b0595bdca8d84ec3a814ceb6bfcad153f4dcda98be04f6ffbe6ca1fb4
MD5 90c160761fcba24d7a9517802b1993b6
BLAKE2b-256 e49af0c29dbb41fa33705a28e89fb552b095909e4ffe75e99349b9b18c340734

See more details on using hashes here.

Provenance

The following attestation bundles were made for node_mantis-0.1.0a10-py3-none-win_amd64.whl:

Publisher: nodemantis-client-release.yml on Node-Mantis/CleanSlate

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

File details

Details for the file node_mantis-0.1.0a10-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for node_mantis-0.1.0a10-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 347dd176ed25786c0198d7629f155bb2fdfaef922a03c4173f22789a858a9908
MD5 b8ad83865b8a335212946fc80b6d4626
BLAKE2b-256 1db4086caf55c97eff28a5df02021047b5c4cdc930ec02db0b70deb5e8188e5e

See more details on using hashes here.

Provenance

The following attestation bundles were made for node_mantis-0.1.0a10-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: nodemantis-client-release.yml on Node-Mantis/CleanSlate

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

File details

Details for the file node_mantis-0.1.0a10-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for node_mantis-0.1.0a10-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 ded96e687cca7f3c6103f8a533a96c2c865b562fb5101de5c0746e9337e0120a
MD5 d586a122838d10974492da7a8b84d23b
BLAKE2b-256 691bff2ff2bc29db59b400c10291a16490ef3371b29cde7421a6d60715203afc

See more details on using hashes here.

Provenance

The following attestation bundles were made for node_mantis-0.1.0a10-py3-none-macosx_11_0_arm64.whl:

Publisher: nodemantis-client-release.yml on Node-Mantis/CleanSlate

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

File details

Details for the file node_mantis-0.1.0a10-py3-none-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for node_mantis-0.1.0a10-py3-none-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 1bc4a8830e529d489a526e0b1a2989bd081168fa4081caee360490deb9acb79f
MD5 9faeb25e5ca7dd1b49c266491fb63f49
BLAKE2b-256 784bd9a88211d7a89d1067f6e7aa7fe6be0f832ccd11292c0a449b9967f9e0dc

See more details on using hashes here.

Provenance

The following attestation bundles were made for node_mantis-0.1.0a10-py3-none-macosx_10_12_x86_64.whl:

Publisher: nodemantis-client-release.yml on Node-Mantis/CleanSlate

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.
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