Product stage: Alpha
Get started

Overview

Node Mantis lets your software run an AI agent that uses the web. The browser capture and actions run on your machine. Task instructions, selected page and DOM context, screenshots, and action history are sent to the hosted service when needed for decisions and retrieval. The service also provides account authentication and usage-based billing.

A browser-agent turn follows this flow:

  1. Your client captures the current page (DOM + screenshot).
  2. It sends selected context to the service, which returns the next action.
  3. Your client executes the action locally, then repeats.

The alpha distribution is named node-mantis on npm and PyPI. The published TypeScript package exposes the browser automation SDK. The next TypeScript alpha moves that SDK to a platform-specific compiled runtime. Python 0.1.0a1 exposes configuration, platform checks, browser installation, diagnostics, and installation smoke tools; it does not expose preflight or browser-driving agent sessions.

Get an API key

Create an account, open the dashboard, and generate an API key before calling Node Mantis.

  1. Go to Sign up and create a Node Mantis account.
  2. Open the dashboard and find the API keys section.
  3. Create a key, copy it when it is shown, and store it as an environment variable or in the Python config file.
export NODEMANTIS_API_KEY="sk_live_<copy-from-dashboard>"

Run this command in the terminal that will start your application. It makes the key available to programs launched by the current shell and is cleared when that shell closes. Anyone with the key can use your account and consume its usage balance, so keep it out of source code, browser bundles, logs, and built artifacts. See API key setup for PowerShell setup.

TypeScript can also receive the key through the apiKey option. Python can store it with python -m nodemantis configure --api-key "$NODEMANTIS_API_KEY".

New here? Start with the Quickstart, or read How it works for the mental model.

Sections