Installation

codeanalyzer-python is published on PyPI and installs with any Python package manager.

Install

pip

pip install codeanalyzer-python

pipx

pipx install codeanalyzer-python

uv

uv tool install codeanalyzer-python

This installs the codeanalyzer command. Verify it:

codeanalyzer --help

Prerequisites

• Python 3.12 or higher.

Why system packages are needed

To analyze a project the way it actually runs, codeanalyzer builds an isolated virtual environment for it (under .codeanalyzer/) using Python’s built-in venv module, installs the project’s dependencies into it, and resolves symbols against that environment. That means the host needs venv support and a compiler toolchain for any dependencies with native extensions.

Ubuntu/Debian

sudo apt update
sudo apt install python3.12-venv python3-dev build-essential

Fedora/RHEL/CentOS

sudo dnf group install "Development Tools"
sudo dnf install python3-pip python3-venv python3-devel

On older releases:

sudo yum groupinstall "Development Tools"
sudo yum install python3-pip python3-venv python3-devel

macOS

# Compiler toolchain
xcode-select --install

# Homebrew Python (recommended)
brew install python@3.12

Using pyenv instead:

pyenv install 3.12.0   # or the latest 3.12.x
pyenv global 3.12.0    # or `pyenv local 3.12.0` per project

Running inside a virtual environment

If you run codeanalyzer from within a virtual environment, it still needs a base interpreter to build the per-project venv. It auto-detects one (via sys.base_executable, then pyenv / conda / asdf / PATH). If detection fails, set SYSTEM_PYTHON to point at a working interpreter:

export SYSTEM_PYTHON=/usr/bin/python3.12

Optional: CodeQL

CodeQL-based resolution is opt-in via --codeql. You do not need to install CodeQL yourself — on first use codeanalyzer downloads the CLI into the project cache (<cache-dir>/codeql/) and reuses it. If a codeql binary is already on your PATH, the project-local copy still takes precedence for deterministic behavior. See CodeQL analysis.

From source (development)

The project uses uv for development.

git clone https://github.com/codellm-devkit/codeanalyzer-python
cd codeanalyzer-python
uv sync --all-groups          # installs runtime + test + dev dependencies
uv run codeanalyzer --input /path/to/python/project

Run the test suite with:

uv run pytest --pspec -s