Homebrew IQToolkit Tap

Homebrew formulae for IQToolkit Analyzer - an AI-powered multi-database performance analyzer for PostgreSQL and MongoDB.

Python Compatibility

IQToolkit Analyzer supports Python 3.11, 3.12, 3.13, and 3.14. The default formula uses Python 3.13, but versioned formulas are available for other Python versions if you have specific compatibility requirements.

Installation

Quick Install (Default - Latest Version with Python 3.13)

brew tap iqtoolkit/iqtoolkit
brew install iqtoolkit-analyzer

Install Specific Version with Specific Python

Version-specific formulas include both the package version and Python version:

Formula	Package Version	Python Version
iqtoolkit-analyzer@0_3_0rc3_py311	v0.3.0rc3	3.11
iqtoolkit-analyzer@0_3_0rc3_py312	v0.3.0rc3	3.12
iqtoolkit-analyzer@0_3_0rc3_py313	v0.3.0rc3	3.13
iqtoolkit-analyzer@0_3_0rc3_py314	v0.3.0rc3	3.14

brew install iqtoolkit-analyzer@0_3_0rc3_py313

Note: Versioned formulas are keg-only. To use them, either:

• Use the full path: /opt/homebrew/opt/iqtoolkit-analyzer@0_3_0rc3_py313/bin/iqtoolkit-analyzer
• Or link it: brew link --force iqtoolkit-analyzer@0_3_0rc3_py313

Usage

iqtoolkit-analyzer --help
iqtoolkit-analyzer --version

Alternative Installation Methods

If you prefer to use your own Python environment:

# Using pipx (recommended for CLI tools)
pipx install iqtoolkit-analyzer

# Using pip in a virtual environment
pip install iqtoolkit-analyzer

Installing a Specific Package Version

For versions not available as Homebrew formulas, use pipx or pip:

# Specific version with your default Python
pipx install iqtoolkit-analyzer==0.2.0

# Specific version with a specific Python version
pipx install iqtoolkit-analyzer==0.2.0 --python python3.11

# Or using pip in a virtual environment
python3.11 -m venv myenv
source myenv/bin/activate
pip install iqtoolkit-analyzer==0.2.0

Updating

brew update
brew upgrade iqtoolkit-analyzer

Uninstalling

brew uninstall iqtoolkit-analyzer
brew untap iqtoolkit/iqtoolkit  # Optional: remove the tap

Troubleshooting

Command not found after installation

Make sure Homebrew's bin directory is in your PATH:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc

Issues with versioned formulas

Versioned formulas are keg-only and not linked by default. To use them:

brew link --force iqtoolkit-analyzer@0_3_0rc3_py313

Or add to your PATH:

export PATH="/opt/homebrew/opt/iqtoolkit-analyzer@0_3_0rc3_py313/bin:$PATH"

License

MIT