Computer Use for Agentic Process Automation!
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 and AgentKind.CORE_AGENT_MINI select the lower-cost Mini variants of
their respective product agents. Named Agent Studio workflows continue to use their persisted Agent
steps.
This would then result in the following trajectory:
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, orLambdaEnvironment. - Create an
Agent(environment=env, kind=...)and callawait agent.run(prompt=...). - Browser actions such as
go_to_url,agentic_selector, and sheet operations are now methods onAgent. - Environments keep lifecycle/bookkeeping APIs such as
start(),close(),browser_window_id, andcloud_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}
}
Metadata
Release files for narada 0.2.11
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| narada-0.2.11.tar.gz | 47.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| narada-0.2.11-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 79.9 kB
Release files / narada-0.2.11.tar.gz
| Download URL | narada-0.2.11.tar.gz |
|---|---|
| Size | 47.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
11a5c597ff618a8d6dea4a6e8c3c320038ee643309b2beaf8f4204c20aabd245
|
|
BLAKE2b-256 checksum How to use checksums |
7e2431195579b557072b21d8771d94e63689d19f27106c8232df589fcf1d49df
|
| 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.11-py3-none-any.whl
| Download URL | narada-0.2.11-py3-none-any.whl |
|---|---|
| Size | 32.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9b3bda0bb15a95c57d00b39db6864ecfc71cd7d9ac8014acf7e2fa149647f20c
|
|
BLAKE2b-256 checksum How to use checksums |
f39828cf642bcfc3f4fcc4e68b4f933e3a97d6140120db3a1adc0ddae124ded3
|
| 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}
|
