> ## Documentation Index
> Fetch the complete documentation index at: https://docs.optexity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Local Setup

Follow these steps to set up your Optexity account, grab your API key, and install the toolchain locally.

### 1. Create an Account

Head to [dashboard.optexity.com](https://dashboard.optexity.com) and sign up for a free account.

### 2. Get Your API Key

Once logged in, navigate to the **API Keys** section in your dashboard and create a new key.

### 3. Install the Recorder Extension

Install the **Optexity Recorder** extension from the [Chrome Web Store](https://chromewebstore.google.com/detail/optexity-recorder/pbaganbicadeoacahamnbgohafchgakp). This extension captures your browser interactions and converts them into automation workflows.

### Prerequisites

* Python 3.11+
* Git

## Create and Activate a Python Environment (Optional)

Choose **one** of the options below.

#### Option A – Conda (includes Python 3.11 and Node.js)

```bash theme={null}
conda create -n optexity python=3.11
conda activate optexity
```

Install miniconda here: [https://docs.conda.io/projects/conda/en/stable/user-guide/install/index.html#installing-in-silent-mode](https://docs.conda.io/projects/conda/en/stable/user-guide/install/index.html#installing-in-silent-mode)

#### Option B – Python `venv`

```bash theme={null}
python3 -m venv .venv
source .venv/bin/activate
```

## Installation

### Quick Installation (from PyPI)

Install Optexity directly from PyPI:

```bash theme={null}
pip install optexity
optexity install-browsers
```

**OR**

### Installation from Source

If you want to clone and edit from source:

```bash theme={null}
git clone git@github.com:Optexity/optexity.git
cd optexity
pip install -e .
optexity install-browsers
```

## Set required environment variables:

```bash theme={null}
OPTEXITY_API_KEY=YOUR_OPTEXITY_API_KEY           # API key used for authenticated requests
GOOGLE_API_KEY=YOUR_GOOGLE_API_KEY      # API key used for Google Gemini
DEPLOYMENT=dev                          # or "prod" in production
```

You can get your free Google Gemini API key from the [Google AI Studio Console](https://aistudio.google.com).