Skip to main content

NARADA AI Logo.

Computer Use for Agentic Process Automation!

Sign Up Documentation Twitter Follow LinkedIn Follow

The official Narada Python SDK that helps you launch browsers and run tasks with Narada UI agents.

Installation

pip install narada

Quick Start

Important: The first time Narada opens the automated browser, you will need to manually install the Narada Enterprise extension and log in to your Narada account.

After installation and login, create a Narada API Key (see this link for instructions) and set the following environment variable:

export NARADA_API_KEY=<YOUR KEY>

That's it. Now you can run the following code to create a browser environment and ask an agent to download a file for you from arxiv:

import asyncio

from narada import Agent, AgentKind, BrowserEnvironment


async def main() -> None:
    # Create the browser environment. It initializes lazily on the first action.
    env = BrowserEnvironment()
    agent = Agent(environment=env)
    mini_agent = Agent(environment=env, kind=AgentKind.OPERATOR_MINI)

    try:
        # Run a task in this browser environment.
        response = await agent.run(
            prompt='Search for "LLM Compiler" on Google and open the first arXiv paper on the results page, then open the PDF. Then download the PDF of the paper.',
            # Optionally generate a GIF of the agent's actions.
            generate_gif=True,
        )

        print("Response:", response.model_dump_json(indent=2))

        # Use the product's lower-cost tier when appropriate.
        mini_response = await mini_agent.run(prompt="Summarize the completed task.")
        print("Mini response:", mini_response.model_dump_json(indent=2))
    finally:
        await env.close()


if __name__ == "__main__":
    asyncio.run(main())

AgentKind.OPERATOR_MINI selects the lower-cost Operator Mini product agent. Named Agent Studio workflows continue to use their persisted Agent steps.

This would then result in the following trajectory:

File Download Example

You can use the SDK to launch browsers and run automated tasks using natural language instructions. For more examples and code samples, please explore the examples/ folder in this repository.

Migration note

This version introduces a non-backward-compatible, agent-centered API:

  • Create an execution target with an environment, such as BrowserEnvironment, CloudBrowserEnvironment, RemoteBrowserEnvironment, or LambdaEnvironment.
  • Create an Agent(environment=env, kind=...) and call await agent.run(prompt=...).
  • Browser actions such as go_to_url, agentic_selector, and sheet operations are now methods on Agent.
  • Environments keep lifecycle/bookkeeping APIs such as start(), close(), browser_window_id, and cloud_browser_session_id.

Features

  • Natural Language Control: Send instructions in plain English to control browser actions
  • Parallel Execution: Run multiple browser tasks simultaneously across different windows
  • Error Handling: Built-in timeout handling and retry mechanisms
  • Action Recording: Generate GIFs of agent actions for debugging and documentation
  • Async Support: Full async/await support for efficient operations

Key Capabilities

  • Web Search & Navigation: Automatically search, click links, and navigate websites
  • Data Extraction: Extract information from web pages using AI understanding
  • Form Interaction: Fill out forms and interact with web elements
  • File Operations: Download files and handle web-based documents
  • Multi-window Management: Coordinate tasks across multiple browser instances

License

This project is licensed under the Apache 2.0 License.

Support

For questions, issues, or support, please contact: support@narada.ai

Citation

We appreciate it if you could cite Narada if you found it useful for your project.

@software{narada_ai2025,
  author = {Narada AI},
  title = {Narada AI: Agentic Process Automation for Enterprise},
  year = {2025},
  publisher = {GitHub},
  url = {https://github.com/NaradaAI/narada-python-sdk}
}
Made with ❤️ in Berkeley, CA.

Metadata

Release files for narada 0.2.10

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for narada 0.2.10
File Size Uploaded
narada-0.2.10.tar.gz 47.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for narada 0.2.10
File Interpreter ABI Platform
narada-0.2.10-py3-none-any.whl Python 3 none any Details

Total release size: 79.8 kB

Release files / narada-0.2.10.tar.gz

Download URL narada-0.2.10.tar.gz
Size 47.8 kB
Tags Source
SHA-256 checksum
How to use checksums
56e935061b6eced1584b12401c9d86cf507ef3af97829dedc1cf8f3aefe77923
BLAKE2b-256 checksum
How to use checksums
492aa0ab05237fe283e74293fad3696e66999cfee41a653b3e525df898aeacb4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / narada-0.2.10-py3-none-any.whl

Download URL narada-0.2.10-py3-none-any.whl
Size 32.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cdcc9f8d2e5b1c1efe0aa9eddb1eca8ac540aea68a772c51035364c6ac9c1b20
BLAKE2b-256 checksum
How to use checksums
c06fa6744afe86a36b9648d43278f7325d3cda4f6a476b1accc4ddfa9ee55512
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

0.2.18

2 release files

0.2.17

2 release files

0.2.16

2 release files

0.2.14

2 release files

0.2.13

2 release files

0.2.12

2 release files

0.2.11

2 release files

This release

0.2.10 This release

2 release files

0.2.9

2 release files

0.2.8

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.52

2 release files

0.1.47

2 release files

0.1.46

2 release files

0.1.44

2 release files

0.1.43

2 release files

0.1.40

2 release files

0.1.39

2 release files

0.1.38

2 release files

0.1.37

2 release files

0.1.36

2 release files

0.1.34

2 release files

0.1.32

2 release files

0.1.31

2 release files

0.1.30

2 release files

0.1.27

2 release files

0.1.26

2 release files

0.1.25

2 release files

0.1.24

2 release files

0.1.23

2 release files

0.1.22

2 release files

0.1.20

2 release files

0.1.19

2 release files

0.1.17

2 release files

0.1.16

2 release files

0.1.15

2 release files

0.1.14

2 release files

0.1.13

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page