> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/automation-api-and-sdks/javascript-and-python-sdk.md).

# JavaScript and Python SDK

Automate your Incogniton profiles from JavaScript/TypeScript or Python with the official incogniton package on npm and PyPI.

Incogniton has official SDKs for JavaScript/TypeScript (`npm install incogniton`) and Python (`pip install incogniton`). Both talk to the [local REST API](https://docs.incogniton.com/automation-api-and-sdks/local-rest-api.md) of the Incogniton app on your computer.

With the SDKs you manage profiles and cookies from code, and launch a profile straight into a browser automation library: Puppeteer or Playwright with the JavaScript SDK, Playwright or Selenium with the Python SDK.

### Before you start

* The Incogniton app must be open and logged in on the same computer as your script.
* The local REST API must be on: **Settings** → **Automation** → **Enable automation API**. This is a paid feature. See [Use the local REST API](https://docs.incogniton.com/automation-api-and-sdks/local-rest-api.md).
* Both SDKs use port `35000` by default. If you changed the **API port** on the Automation tab, pass your port to the client.
* You need the ID of the profile you want to automate. Expand the profile in the profile list and click **Copy** next to **Profile ID**.

Your script drives the browser that Incogniton launches for the profile, so the profile's fingerprint, proxy and cookies are used. No separate browser is downloaded.

### Install and examples

The install steps, the full method reference and code examples are in the developer documentation:

* [SDK overview](https://api-docs.incogniton.com/sdks/overview)
* [Node.js SDK](https://api-docs.incogniton.com/sdks/nodejs) (JavaScript/TypeScript, Puppeteer and Playwright)
* [Python SDK](https://api-docs.incogniton.com/sdks/python) (Playwright and Selenium)
* [Automation examples](https://api-docs.incogniton.com/how-to-guides/automation-examples): ready-to-run Puppeteer, Playwright and Selenium scripts

{% hint style="info" %}
Launch each profile only once at a time. If a profile is already running, the app refuses a second launch and the SDK returns an error with the app's message.
{% endhint %}

### More automation options

* [Use the local REST API](https://docs.incogniton.com/automation-api-and-sdks/local-rest-api.md): call the endpoints directly.
* Incogniton CLI: run the same actions from a terminal. Click **Download CLI** on the **Automation** tab. See the [CLI documentation](https://api-docs.incogniton.com/cli).
* [Connect AI clients with MCP](https://docs.incogniton.com/automation-api-and-sdks/connect-ai-clients-mcp.md): let an AI client manage your profiles.
