praisonai-browser Package

praisonai-browser is the standalone package that powers AI browser automation — the bridge server, CDP agent, and Playwright engine — usable on its own or inside the full praisonai stack.

from praisonaiagents import Agent

agent = Agent(name="browser-agent", instructions="Browse the web and complete tasks in Chrome.")
agent.start("Go to google and search praisonai, then summarise the top result.")

The agent states a goal; praisonai-browser drives Chrome until the task completes.

Quick Start

Install the package

pip install praisonai-browser

Run a goal from the CLI

praisonai-browser run "Go to google and search praisonai"

Or use the Python API

from praisonai_browser import BrowserServer

server = BrowserServer(port=8765, model="gpt-4o")
server.start()  # Blocks; connect the Chrome extension to it

Install

Pick the extras you need — core alone covers the CLI and CDP agent.

pip install praisonai-browser            # core
pip install "praisonai-browser[server]"  # FastAPI bridge server
pip install "praisonai-browser[playwright]"  # cross-browser Playwright engine
pip install "praisonai-browser[all]"     # everything

Extra	Adds	Use it for
(none)	`rich`, `typer`, `click`	Core CLI and CDP agent
`server`	`fastapi`, `uvicorn`, `websockets`, `aiohttp`	Bridge server + Chrome extension
`playwright`	`playwright`	Firefox/WebKit and headless runs
`all`	Everything above	Full feature set

pip install "praisonai[all]" (or praisonai[browser]) installs praisonai-browser for you as part of the umbrella product.

Console Entry Point

The package ships a praisonai-browser console script that mirrors the praisonai browser subcommands.

praisonai-browser --help
praisonai-browser run "Go to google and search praisonai"
praisonai-browser doctor

Inside the full stack the same commands are available as praisonai browser ….

Python API

Import the public classes straight from praisonai_browser.

from praisonai_browser import (
    BrowserServer,
    BrowserAgent,
    SessionManager,
    CDPBrowserAgent,
    run_cdp_only,
    run_hybrid,
)

Export	What it does
`BrowserServer`	FastAPI + WebSocket bridge for the Chrome extension
`BrowserAgent`	Decides the next action from a page observation
`SessionManager`	SQLite-backed session and step history
`CDPBrowserAgent`	Drives Chrome directly over CDP (no extension)
`run_cdp_only`	One-call CDP automation runner
`run_hybrid`	CDP with on-device fallback

Protocol Types

The lightweight type definitions live in the agents tier and are shared across engines.

from praisonaiagents.tools.protocols.browser import (
    BrowserAction,
    BrowserActionType,
    BrowserObservation,
    BrowserSession,
)

BrowserActionType includes click, type, scroll, navigate, wait, screenshot, evaluate, submit, clear_input, and done.

Backward Compatibility

Everything from the pre-extraction layout keeps working.

Old usage	Still works	Canonical form
`from praisonai.browser import BrowserServer, BrowserAgent`	✅	`from praisonai_browser import BrowserServer, BrowserAgent`
`from praisonai.browser.sessions import SessionManager`	✅	`from praisonai_browser import SessionManager`
`praisonai browser run "…"`	✅	`praisonai-browser run "…"`
`python -m praisonai.browser.server`	✅	`praisonai-browser start`

praisonai.browser is a compatibility shim that re-exports praisonai_browser, so existing scripts need no changes.

Best Practices

Install only the extras you use

Core covers the CLI and CDP agent. Add [server] for the Chrome extension bridge and [playwright] for Firefox/WebKit or headless runs.

Prefer the canonical import

Import from praisonai_browser in new code. The praisonai.browser shim stays for existing scripts.

Use the standalone CLI in slim environments

praisonai-browser runs without the full wrapper, keeping browser-only images small.

Run doctor before your first session

praisonai-browser doctor checks the server, Chrome debugging, extension, and session database in one pass.

Browser Agent

Setup, CLI reference, and supported actions.

Browser Agent Deep Dive

Execution modes, APIs, and package layout in detail.

Gateway Self-Lifecycle Guard

Browser Agent Module

​Quick Start

​Install

​Console Entry Point

​Python API

​Protocol Types

​Backward Compatibility

​Best Practices

​Related

Browser Agent

Browser Agent Deep Dive

Quick Start

Install

Console Entry Point

Python API

Protocol Types

Backward Compatibility

Best Practices

Related