Install quelltest for Python
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?
pip install quelltest
uv add quelltest
Check the install:
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. |
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?
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 and quell auth.
Next steps
Continue to the Python quickstart.
Working in JavaScript or TypeScript? The npm package has the same name: see npm installation.