Installation

This guide covers installing conllu_tools for various use cases.

Quick Install

Install the latest version using pip:

pip install conllu_tools

This installs the package and all required dependencies.

Requirements

System Requirements

  • Python: 3.9 or higher

  • Operating System: macOS, Linux, or Windows

Other Installation Methods

From Source

git clone https://github.com/gpizzorno/conllu_tools.git
cd conllu_tools
pip install -e .

From GitHub (Direct)

Install the latest development version without cloning:

pip install git+https://github.com/gpizzorno/conllu_tools.git

Specific Version

Install a specific version from GitHub:

pip install git+https://github.com/gpizzorno/conllu_tools.git@v1.0.0

Upgrade

Update to the latest version:

cd conllu_tools
git pull origin main
pip install -e . --upgrade

Troubleshooting

Import Error: No module named ‘conllu_tools’

Problem: Python cannot find the installed package.

Solutions:

  1. Verify installation:

pip list | grep conllu_tools

  1. Check that you’re using the correct Python environment:

which python
python -m site

  1. Reinstall the package:

pip uninstall conllu_tools
pip install -e .

Version Conflicts

Problem: Dependency version conflicts during installation.

Solutions:

  1. Use a fresh virtual environment:

python -m venv fresh_env
source fresh_env/bin/activate
pip install -e .

  1. Update pip:

pip install --upgrade pip setuptools wheel

  1. Install with --no-deps and manually install dependencies:

pip install --no-deps -e .
pip install -r requirements.txt

Permission Errors

Problem: Permission denied during installation.

Solutions:

  1. Use virtual environment (recommended):

python -m venv myenv
source myenv/bin/activate
pip install -e .

  1. Use user installation:

pip install --user -e .

Next Steps

After installation, see: