Installation

NOIV can be installed in multiple ways depending on your preference and environment.

Quick Installation

The fastest way to get started with NOIV is using pip:

Linux/macOS Recommended

pip install --user --upgrade noiv
export PATH="$HOME/.local/bin:$PATH"

pipx

pipx install noiv

Windows

pip install --upgrade noiv

Verify Installation

After installation, verify that NOIV is working correctly:

Linux/macOS

noiv --help

Windows Command Prompt

noiv --help

Windows PowerShell

noiv --help

You should see the NOIV help menu and version information.

System Requirements

• Python: 3.8 or higher
• Operating System: Linux, macOS, or Windows
• Internet Connection: Required for AI features
• Dependencies: Automatically installed with pip

Installation Options

Using pip (Recommended)

pip install --user --upgrade noiv
export PATH="$HOME/.local/bin:$PATH"

Add the export line to your .bashrc, .zshrc, or .profile for permanent access:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Using pipx (Isolated Installation)

If you prefer to install NOIV in an isolated environment:

# Install pipx if you don't have it
pip install pipx

# Install NOIV with pipx
pipx install noiv

Windows

pip install --upgrade noiv

The NOIV CLI will be available in your Python Scripts directory (usually added to PATH by default).

Development Installation

For development or contributing to NOIV:

git clone https://github.com/crs7617/noiv.git
cd noiv
pip install -e .

Troubleshooting

Permission Issues

If you encounter permission errors during installation:

Linux/macOS

pip install --user --upgrade noiv
export PATH="$HOME/.local/bin:$PATH"

Windows

pip install --upgrade noiv

Command Not Found

If you installed with pip and noiv is not found, add this to your shell:

export PATH="$HOME/.local/bin:$PATH"

Or add it to your .bashrc, .zshrc, or .profile for permanent access.

Python Version Issues

NOIV requires Python 3.8+. Check your Python version:

python --version

If you have multiple Python versions, you might need to use pip3:

pip3 install --user --upgrade noiv

Network Issues

If installation fails due to network issues:

pip install --index-url https://pypi.org/simple/ noiv
pip install --upgrade pip
pip install --user --upgrade noiv

Next Steps

Once NOIV is installed, head over to the Quick Start Guide to run your first test!

TIP

Need help? Check out our troubleshooting guide or open an issue on GitHub.