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 5, 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 5, 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.0a11-py3-none-win_amd64.whl (3.0 MB view details)

Uploaded Python 3Windows x86-64

node_mantis-0.1.0a11-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (3.2 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ x86-64

node_mantis-0.1.0a11-py3-none-macosx_11_0_arm64.whl (2.8 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

node_mantis-0.1.0a11-py3-none-macosx_10_12_x86_64.whl (3.1 MB view details)

Uploaded Python 3macOS 10.12+ x86-64

File details

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

File metadata

File hashes

Hashes for node_mantis-0.1.0a11-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 1dec27f89ddf479e75ae56e470141bf400a4cd0cb0c0110b4517fb8f53b682cc
MD5 40db34cb6fb9a1177aa8c6b3e8b9e26d
BLAKE2b-256 0a96a4830ab9e86ba6fadc6100135ef9c86d5033c7c726f71df74093e4473f95

See more details on using hashes here.

Provenance

The following attestation bundles were made for node_mantis-0.1.0a11-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.0a11-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for node_mantis-0.1.0a11-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 2f42c549c81ef5fe4b00e3220ba7e353b9be9627662c8988036b654e9c1b8cb4
MD5 906e01508a6aec1404e9ea7406b6438a
BLAKE2b-256 7439113c243c186cffd4eb0c4b1c68837ba41f3810c97406105305ff621677bc

See more details on using hashes here.

Provenance

The following attestation bundles were made for node_mantis-0.1.0a11-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.0a11-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for node_mantis-0.1.0a11-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 ead98c4d4aa6d0c83ad5cc4a059e5ac5ca65c301fc7d478b26e86c9a976f8ecf
MD5 e276df8882d060750723da68718aec5c
BLAKE2b-256 77401c7f20e9dfb09fe463625b7b0b3880e6be43fd74875230b12874c6bc51dd

See more details on using hashes here.

Provenance

The following attestation bundles were made for node_mantis-0.1.0a11-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.0a11-py3-none-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for node_mantis-0.1.0a11-py3-none-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 ff644a8cfd65167cf43e6d88d066e333dd5e94eafe20aa863359ec8995a4b9e9
MD5 11ff64f6de129ef993058ab0e82a044e
BLAKE2b-256 bfe4019b5a96537e40fa556baa412bb0c24036437a2d6603960034a0bfe53cc4

See more details on using hashes here.

Provenance

The following attestation bundles were made for node_mantis-0.1.0a11-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