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.0a12-py3-none-win_amd64.whl (3.1 MB view details)

Uploaded Python 3Windows x86-64

node_mantis-0.1.0a12-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.0a12-py3-none-macosx_11_0_arm64.whl (2.8 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

node_mantis-0.1.0a12-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.0a12-py3-none-win_amd64.whl.

File metadata

File hashes

Hashes for node_mantis-0.1.0a12-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 8f62d1e6eb3d2887d3ac6190de8dc70dd65c8ce310626109f0d610efd79438b5
MD5 04d6ab141ed4ff4048e4e933f1003170
BLAKE2b-256 28324263dd555073b0ff86cf618fff78596ce5f08b0c3b888820f72a095ef70c

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for node_mantis-0.1.0a12-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 ebdd068aa92c0803c89a65b28446da366c4c56a03cdf58e86eb30da4b49af834
MD5 4a4220bc9666566b37f1f44e6ba07ea3
BLAKE2b-256 a9344e64462c220999344694bb67edd8e37b5c8253d3d7998be6afaa60e39711

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for node_mantis-0.1.0a12-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 71ba675fb32e4d08faae1d6c533f53f91999d5cb7df1d5f939866b3391081585
MD5 f50761bafa6358758901fff3da22f8b7
BLAKE2b-256 5e54660974e93fd88c8d98c2481f81d88b4667b4f69450ce383a4c78f84af086

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for node_mantis-0.1.0a12-py3-none-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 aa703403aed60e090d73ce871c747bde3f355b25f98064d32c211a6252b11de4
MD5 b1f9b2544297dbbdeb49718063257aa7
BLAKE2b-256 b56910f39429bd6b9f3693c6fc5fcee81b8a471ec65914b71efab5f5af54ac41

See more details on using hashes here.

Provenance

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