Querion / Get started
Installation
Requirements for Querion, including the Claude Code CLI, and how to install it from a clone with optional extras.
Requirements
- Python 3.9 or newer (
requires-python = ">=3.9"inpyproject.toml). - A Postgres database. A dedicated read-only role is strongly recommended.
- The Claude Code command-line interface (CLI), installed and logged in on the machine that runs Querion.
- Optional: matplotlib for chart images. Without it, the model receives a text chart instead.
The Claude Code CLI requirement
Querion has no application programming interface (API) key setting. It does not talk to a model service itself. Every model call runs claude -p --output-format json as a subprocess, with these arguments:
--model, set frommodelin your config.--strict-mcp-config, so no Model Context Protocol (MCP) servers are loaded.--system-prompt, with the analyst prompt.--disallowed-tools, for Bash, Edit, Write, Read, Glob, Grep, WebFetch, WebSearch, NotebookEdit and Task.
The question and the running transcript are sent on standard input. Authentication lives wherever the Claude Code CLI keeps it for the user that runs Querion, so log in once on the host as that user:
claude
If the binary is not on PATH, set claude_bin in querion.yaml. See Configuration.
Install
Querion is not published on the Python Package Index (PyPI). Install from a clone:
git clone https://github.com/anishfyi/querion.git
cd querion
pip install -e ".[all]"
Extras
The core install needs pyyaml, psycopg2-binary and requests. That is enough for querion check, querion introspect and querion ask. The extras defined in pyproject.toml add the rest:
web:fastapianduvicorn, needed forquerion serve.charts:matplotlib, for chart images.dotenv:python-dotenv, so the CLI loads a.envfile automatically.all: all of the above.
To install only the terminal tools plus .env loading, for example:
pip install -e ".[dotenv]"
requirements.txt lists the same packages, all extras included, if you prefer pip install -r requirements.txt.
Verify
querion --version
querion check
querion --version prints querion 0.1.0. querion check needs a querion.yaml; the Quickstart creates one. If either command fails, see Troubleshooting.