Skip to content

Installation

Requirements

  • Python 3.8 or higher
  • pip package manager

Install from PyPI

The easiest way to install FuzzyInfer:

pip install fuzzy-infer

Install with Optional Dependencies

CLI Support

For the interactive command-line interface:

pip install "fuzzy-infer[cli]"

Development Tools

For development and testing:

pip install "fuzzy-infer[dev]"

All Features

Install everything:

pip install "fuzzy-infer[all]"

Install from Source

Latest Development Version

git clone https://github.com/queelius/fuzzy-infer.git
cd fuzzy-infer
pip install -e .

Specific Version

git clone --branch v2.0.0 https://github.com/queelius/fuzzy-infer.git
cd fuzzy-infer
pip install .

Verify Installation

Python Import

import fuzzy_infer
print(fuzzy_infer.__version__)
# Output: 2.0.0

Command-Line

fuzzy-infer --version
# Output: fuzzy-infer version 2.0.0

Using venv

python -m venv fuzzy-env
source fuzzy-env/bin/activate  # On Windows: fuzzy-env\Scripts\activate
pip install fuzzy-infer

Using conda

conda create -n fuzzy-env python=3.10
conda activate fuzzy-env
pip install fuzzy-infer

Docker

Official Image

docker pull ghcr.io/queelius/fuzzy-infer:latest
docker run -it ghcr.io/queelius/fuzzy-infer:latest fuzzy-infer --help

Build Your Own

FROM python:3.10-slim
RUN pip install fuzzy-infer
CMD ["fuzzy-infer", "repl"]

Platform-Specific Notes

macOS

# Using Homebrew Python
brew install python@3.10
pip3 install fuzzy-infer

Ubuntu/Debian

sudo apt update
sudo apt install python3-pip
pip3 install fuzzy-infer

Windows

# Using Windows Terminal or PowerShell
py -m pip install fuzzy-infer

Troubleshooting

Permission Errors

If you encounter permission errors:

pip install --user fuzzy-infer

Dependency Conflicts

Use a virtual environment to avoid conflicts:

python -m venv clean-env
source clean-env/bin/activate
pip install fuzzy-infer

Behind a Proxy

pip install --proxy http://proxy.example.com:8080 fuzzy-infer

Uninstalling

pip uninstall fuzzy-infer

Next Steps