AgentQL Python SDK Installation

Prerequisites

note

You may want to use a virtual environment, but it's not required.

Installation options

There are two ways to install AgentQL SDK:

  • AgentQL CLI installation — Get set up fast by installing the AgentQL library and then using AgentQL CLI to download dependencies and setup AgentQL API Key.
  • Manual installation — For a more customized setup, manually install the AgentQL SDK.

Option 1: AgentQL CLI Installation

1. Install AgentQL library

From your terminal, run the following command to install the AgentQL library:

terminal
pip3 install agentql

2. Install dependencies and set API key

The following AgentQL CLI command will prompt you for your API key. When prompted, simply copy and paste your AgentQL API key into the terminal.

terminal
agentql init

Option 2: Manual Installation

From your terminal, run the following command to install the AgentQL library:

1. Install AgentQL library

terminal
pip3 install agentql

2. Install playwright driver

The default version of AgentQL Python SDK uses Playwright as a web driver, so Playwright dependencies need to be installed.

terminal
playwright install chromium

3. Set your AgentQL API Key

Set the AGENTQL_API_KEY environment variable with your API key.

To set the environment variable temporarily for your terminal session, in your terminal run

terminal
export AGENTQL_API_KEY=your-api-key

Run Your First AgentQL Script

Now you are ready to run your first AgentQL script! Continue to First Steps to get started.