Skip to content
Querion

Querion / Get started

Installation

Requirements for Querion, including the Claude Code CLI, and how to install it from a clone with optional extras.

On this page
  1. Requirements
  2. The Claude Code CLI requirement
  3. Install
  4. Extras
  5. Verify

Requirements

  • Python 3.9 or newer (requires-python = ">=3.9" in pyproject.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 from model in 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: fastapi and uvicorn, needed for querion serve.
  • charts: matplotlib, for chart images.
  • dotenv: python-dotenv, so the CLI loads a .env file 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.