Skip to main content

Node Mantis

Node Mantis automates web tasks with AI. Describe a goal in plain English and it carries the goal out in a real Chrome browser on your machine, navigating, clicking, typing and reading the page the way a person would, then returns the result to your code. Use it from Python, Node.js or the command line; it uses your Google Chrome (or provides Chrome for Testing when Chrome is missing), and new accounts start with $10 in free credit.

python -m pip install --upgrade node-mantis
export NODEMANTIS_API_KEY="sk_live_<copy-from-dashboard>"
import asyncio
from nodemantis import NodeMantis


async def main():
    async with await NodeMantis.start() as mantis:
        result = await mantis.run(
            "Go to https://sandbox.nodemantis.com. Open Travel & Adventure, add one copy of Journey to the Center of the Earth to the cart, then open the cart and report the title and quantity.",
        )
        print("Status:", "success" if result.ok else "failed")
        print(result.reason)


asyncio.run(main())

Quickstart · Docs · API reference · Get an API key · Pricing · Website

MCP server

Node Mantis includes a Model Context Protocol server, so an assistant that supports MCP can give it website tasks. Add it to the assistant's MCP settings:

{
  "mcpServers": {
    "node-mantis": {
      "command": "uvx",
      "args": ["node-mantis", "mcp"],
      "env": { "NODEMANTIS_API_KEY": "sk_live_<copy-from-dashboard>" }
    }
  }
}

Without uv, install the package and use "command": "nodemantis", "args": ["mcp"].

It offers four tools. run_task carries out a task from a plain-English goal, retrieve_data reads data from one page, and get_task and cancel_task follow up on work that takes longer than one call. Pass result_schema (a JSON Schema) to get the data in a fixed shape. Secrets work as on the command line: the assistant passes only names, and each value comes from NODEMANTIS_SECRET_<NAME> in the server's environment. See the MCP guide.

Secrets

Pass passwords, API keys and one-time codes with secrets. The values stay in the local Node Mantis process; only their names are shared, and Node Mantis types a value into the page when the task asks for it by name.

result = await mantis.run(
    "Sign in as the user ada with the account password.",
    secrets={"account_password": os.environ["ACCOUNT_PASSWORD"]},
)

On the command line, pass --secrets account_password and set NODEMANTIS_SECRET_ACCOUNT_PASSWORD. Names use letters, digits and underscores, and you can point at one in a prompt as <secret:account_password>. The value never leaves your machine while it is typed, and password fields are hidden in the page snapshot. Use secrets with fields that hide what you type: a page that shows the value as readable text exposes it like any other page content. See Secrets.

Browser

Node Mantis drives Google Chrome. It uses, in order: CHROME_PATH, your installed Google Chrome, or Chrome for Testing (Google's official automation build of Chrome) in a private Node Mantis cache. If none exists, it downloads the latest Stable Chrome for Testing (about 200 MB) the first time a browser is needed (Python wheels cannot run install steps); nodemantis install-browser does it ahead of time and nodemantis doctor shows which browser is used. No admin rights are needed and your own browser is never touched. To remove it, delete the cache folder: ~/Library/Caches/nodemantis/chrome (macOS), %LOCALAPPDATA%\nodemantis\cache\chrome (Windows) or ~/.cache/nodemantis/chrome (Linux, honours XDG_CACHE_HOME). Set NODEMANTIS_SKIP_BROWSER_DOWNLOAD=1 to turn every automatic download off, for example on locked-down machines. On Linux, Chrome for Testing needs the usual Chrome system libraries (libnss3, libatk-bridge2.0-0, libgbm1, libasound2, ...); nodemantis doctor names any that are missing.

Startup-failure reports

If a run, session start or nodemantis doctor fails before the first step reaches the Node Mantis API (for example the engine is missing, Chrome does not launch, the API key is rejected, or the network is down), the SDK sends one short report to https://api.nodemantis.com/v2/client-events so we can fix first-run problems we would otherwise never see. It is sent in the background with a 2-second limit and never changes output or exit codes.

  • Sent: which step failed, an error code, a short error message with URLs, file paths, email addresses and keys removed, the SDK, engine, OS, CPU and Node.js/Python versions, the command, how the CLI was installed (when known), whether it runs in CI, and a random install ID stored next to your config file. When an API key is configured it is sent as the usual Authorization header so the report is linked to your account.
  • Never sent: your task or prompt, page URLs or content, selectors, file paths, environment variables, or the API key itself in the report.
  • Opt out: set NODEMANTIS_TELEMETRY=0 (or false/off), or DO_NOT_TRACK=1. nodemantis doctor --offline never sends one.

Metadata

Release files for node-mantis 0.1.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for node-mantis 0.1.9
File Actions
node_mantis-0.1.9-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for node_mantis-0.1.9-py3-none-win_amd64.whl
node_mantis-0.1.9-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for node_mantis-0.1.9-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
node_mantis-0.1.9-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for node_mantis-0.1.9-py3-none-macosx_11_0_arm64.whl
node_mantis-0.1.9-py3-none-macosx_10_12_x86_64.whl Python 3 none macOS 10.12+ x86-64 Details for node_mantis-0.1.9-py3-none-macosx_10_12_x86_64.whl

Total release size: 43.9 MB

Release files / node_mantis-0.1.9-py3-none-win_amd64.whl

Download URL node_mantis-0.1.9-py3-none-win_amd64.whl
Size 10.9 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
662df16bfd3143469151833dc75e972939fac403960c9e7021e73ff80252673d
BLAKE2b-256 checksum
How to use checksums
eb6079bb6cf4a11a675a7a64bd72a48b0fe23ebea96b8f688bb074712d781a30
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

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 Nov 18, 2026.

Transparency log

Release files / node_mantis-0.1.9-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL node_mantis-0.1.9-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 11.6 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
3d3858a8e5f6e62ea76b80cf1c1b0b866f79b7e2e9a527c2d6d08d2705853023
BLAKE2b-256 checksum
How to use checksums
4474aaf6acc8e0eb703cfb0cca98d3b7cc5918bdc37a33f406f16eafa88264d5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

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 Nov 18, 2026.

Transparency log

Release files / node_mantis-0.1.9-py3-none-macosx_11_0_arm64.whl

Download URL node_mantis-0.1.9-py3-none-macosx_11_0_arm64.whl
Size 9.9 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
d0fd5e20f92b0ce4c8e713af1acf43eed0913ed72f036b9277fef023715806b8
BLAKE2b-256 checksum
How to use checksums
600e0bd40fa384a4274d2738433c75c1797da25c68dd9e9204ac11a081ff06fb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

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 Nov 18, 2026.

Transparency log

Release files / node_mantis-0.1.9-py3-none-macosx_10_12_x86_64.whl

Download URL node_mantis-0.1.9-py3-none-macosx_10_12_x86_64.whl
Size 11.5 MB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
0a4f8ff95516f95e488dcfc2a6084a0667d587ec6ee373962a88ea94d97c8a1f
BLAKE2b-256 checksum
How to use checksums
44e7fba0f964fcb02dd82efc661c0c829896931e38e0b1fb534418d6347ff9d0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

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 Nov 18, 2026.

Transparency log

Security for node-mantis 0.1.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.

Full provenance

All 4 files in this release have been uploaded with provenance metadata.

Select from 4 files

Attestation for node_mantis-0.1.9-py3-none-win_amd64.whl

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 Nov 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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