Metadata-Version: 2.4
Name: node-mantis
Version: 0.1.8
Summary: Automate web tasks with AI: describe them in plain English and Node Mantis runs them in a real Chrome browser. Python, Node and CLI.
Author: NodeMantis
License-Expression: LicenseRef-NodeMantis-Proprietary
Project-URL: Homepage, https://nodemantis.com
Project-URL: Documentation, https://nodemantis.com/docs
Project-URL: Quickstart, https://nodemantis.com/docs/quickstart
Project-URL: Pricing, https://nodemantis.com/pricing
Project-URL: Changelog, https://nodemantis.com/changelog
Project-URL: Slack community, https://join.slack.com/t/nodemantis/shared_invite/zt-4flargedf-cPE52O2q~bXHaL_xp1L0cg
Keywords: browser automation,web automation,ai agent,browser agent,llm,playwright,puppeteer alternative,selenium alternative,headless browser,chrome,natural language,rpa,web testing,node-mantis,nodemantis
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Dynamic: license-file

# 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.

```bash
python -m pip install --upgrade node-mantis
export NODEMANTIS_API_KEY="sk_live_<copy-from-dashboard>"
```

```python
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](https://nodemantis.com/docs/quickstart)** · [Docs](https://nodemantis.com/docs) · [API reference](https://nodemantis.com/docs/parameters) · [Get an API key](https://nodemantis.com/signup) · [Pricing](https://nodemantis.com/pricing) · [Website](https://nodemantis.com)

## 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.

```python
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](https://nodemantis.com/docs/concepts#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.
