Metadata-Version: 2.4
Name: node-mantis
Version: 0.1.0a9
Summary: NodeMantis Python configuration, browser setup, and installation validation tools
Author: NodeMantis
License-Expression: LicenseRef-NodeMantis-Proprietary
Project-URL: Homepage, https://github.com/Node-Mantis/CleanSlate#readme
Project-URL: Repository, https://github.com/Node-Mantis/CleanSlate
Project-URL: Issues, https://github.com/Node-Mantis/CleanSlate/issues
Keywords: browser,automation,playwright,node-mantis,nodemantis
Classifier: Development Status :: 3 - Alpha
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
Provides-Extra: browser
Requires-Dist: playwright>=1.59.1; extra == "browser"
Dynamic: license-file

# NodeMantis Python

Python configuration, browser setup, and installation validation tools for NodeMantis.

This wheel is not the browser-automation runtime. The customer automation SDK
ships its platform-selected compiled Rust runtime through npm; the Python
package contains only configuration, preflight, browser-install, and smoke-test
helpers. It has no public runtime-path or service-endpoint selector.

Customer install:

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

`node-mantis[browser]` installs Playwright for SDK-managed browser 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`. 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.

The package always connects to the hosted Node Mantis API. The service endpoint
is not customer-configurable.

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

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

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