# Install quelltest for Python

> Install the quelltest PyPI package (MIT, Python 3.11+) with pip or uv, add optional extras for Groq, PySpark and MCP, and verify the quell command works.

Canonical page: https://quelltest.com/docs/installation

The `quelltest` package on PyPI installs the `quell` command for Python projects. It requires Python 3.11 or newer, is released under the MIT licence, and needs pytest in the project you want to test. Its rule engine works offline with no API key.

## What are the requirements?

- Python 3.11 or newer (3.11, 3.12 and 3.13 are listed in the package classifiers). Linux, macOS and Windows.
- pytest in the environment that runs your tests: generated tests are verified by running pytest in a subprocess.
- Dependencies installed automatically: Typer, Rich, Pydantic v2, libcst, the Anthropic and OpenAI SDKs, httpx and GitPython.

## How do I install it?

```bash
pip install quelltest
```

```bash
uv add quelltest
```

Check the install:

```bash
quell --version
quell --help
```

`quell --version` prints `quelltest <version>`.

## Which extras are available?

| Extra | Install | Adds |
| --- | --- | --- |
| `mcp` | `pip install "quelltest[mcp]"` | The local MCP server for AI agents (`quelltest-mcp`). See [MCP server and plugin](https://quelltest.com/docs/mcp.md). |
| `groq` | `pip install "quelltest[groq]"` | The Groq SDK for the optional LLM fallback. |
| `keyring` | `pip install "quelltest[keyring]"` | OS keyring storage for credentials. |
| `llm` | `pip install "quelltest[llm]"` | `groq` and `keyring` together. |
| `pyspark` | `pip install "quelltest[pyspark]"` | PySpark schema scanning. |

## How do I install it for development?

```bash
git clone https://github.com/quelltest/quelltest-lib.git
cd quelltest-lib
uv sync --dev
uv run quell --help
uv run pytest tests/ -v
```

## Do I need an API key?

No. The rule engine reads guard clauses, docstrings and types and writes tests without any network call. An LLM is an opt-in fallback for cases the rules cannot handle: store a key with `quell auth set --provider groq --key ...` and pass `--use-llm`. See [LLM providers](https://quelltest.com/docs/configuration/llm-providers.md) and [`quell auth`](https://quelltest.com/docs/cli/auth.md).

## Next steps

Continue to the [Python quickstart](https://quelltest.com/docs/quickstart.md).

Working in JavaScript or TypeScript? The npm package has the same name: see [npm installation](https://quelltest.com/docs/npm/installation.md).
