Skip to content

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?

ExtraInstallAdds
mcppip install "quelltest[mcp]"The local MCP server for AI agents (quelltest-mcp). See MCP server and plugin.
groqpip install "quelltest[groq]"The Groq SDK for the optional LLM fallback.
keyringpip install "quelltest[keyring]"OS keyring storage for credentials.
llmpip install "quelltest[llm]"groq and keyring together.
pysparkpip 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.