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

# Installation

> Install JobSpy with pip. Requires Python 3.10 or higher.

<Warning>
  JobSpy requires **Python 3.10 or higher**. Check your version with `python --version` before installing.
</Warning>

## Install JobSpy

<Steps>
  <Step title="Install the package">
    Install JobSpy from PyPI using pip:

    ```bash theme={null}
    pip install -U python-jobspy
    ```

    The `-U` flag upgrades JobSpy to the latest version if you already have it installed.
  </Step>

  <Step title="Verify the installation">
    Confirm the package installed correctly by running a quick import in your terminal:

    ```python theme={null}
    python -c "from jobspy import scrape_jobs; print('JobSpy installed successfully')"
    ```

    You should see `JobSpy installed successfully` printed to the console.
  </Step>
</Steps>

## Requirements

JobSpy installs the following dependencies automatically:

| Package          | Purpose                                    |
| ---------------- | ------------------------------------------ |
| Python `>=3.10`  | Minimum runtime version                    |
| `pandas`         | Returns results as a DataFrame             |
| `pydantic`       | Validates job post data models             |
| `beautifulsoup4` | Parses HTML from job board pages           |
| `requests`       | Makes HTTP requests to job boards          |
| `tls-client`     | Handles TLS fingerprinting to avoid blocks |
| `markdownify`    | Converts HTML job descriptions to Markdown |
| `numpy`          | Supports DataFrame operations              |
| `regex`          | Extended regex for salary parsing          |

<Note>
  You do not need to install these packages manually. They are declared as dependencies and installed alongside `python-jobspy`.
</Note>

## Upgrading an existing installation

To upgrade to the latest version of JobSpy at any time, run the same install command with the `-U` flag:

```bash theme={null}
pip install -U python-jobspy
```

You can check which version you have installed with:

```bash theme={null}
pip show python-jobspy
```