intent-base-sdk 0.4.0

intent-base Python SDK: launch isolated Profiles via the local Profile Service and drive them with Playwright over CDP.

intent-base-sdk

Python SDK for intent-base: launch an isolated Profile through the local Profile Service and drive it with Playwright over CDP. The SDK never launches Chromium itself — only the Profile Service does.

Install (PyPI)

Requires Profile Service running (default http://127.0.0.1:17390).

pip install intent-base-sdk==0.4.0
pip install "intent-base-sdk[playwright]==0.4.0"
playwright install chromium

The base package only needs httpx. Playwright is an optional extra.

Configuration

Option	Default	Environment variable
service_url	http://127.0.0.1:17390	INTENT_BASE_SERVICE_URL
timeout_ms	30000	INTENT_BASE_TIMEOUT_MS

Sync usage

from intent_base import launch_profile

result = launch_profile("profile_123")
result.page.goto("https://example.com")
print(result.page.title())
result.close()

Pass auto_stop=True to also stop the Profile on close().

Async usage

import asyncio
from intent_base import launch_profile_async

async def main():
    result = await launch_profile_async("profile_123")
    await result.page.goto("https://example.com")
    print(await result.page.title())
    await result.aclose()

asyncio.run(main())

Errors

from intent_base import launch_profile, ProfileAlreadyRunningError, IntentBaseError

try:
    result = launch_profile("profile_123")
except ProfileAlreadyRunningError as err:
    print("already running:", err.code)
except IntentBaseError as err:
    print(err.code, err.message, err.status)

Monorepo development

pip install -e "sdks/python[dev,playwright]"
python -m pytest sdks/python/tests

See docs/PUBLISH.md for PyPI release steps.