Command line interface for accessing the Open Web Index shards and slices.
Readme.md
# OWILIX - Open Web Index CLI [![Version](https://img.shields.io/badge/version-5.10.9-blue.svg)](https://openwebsearcheu-public.pages.it4i.eu/owi-cli/) [![Python](https://img.shields.io/badge/python-3.11+-green.svg)](https://www.python.org/) [![License](https://img.shields.io/badge/license-Apache_2.0-orange.svg)](http://www.apache.org/licenses/LICENSE-2.0) A command-line tool for managing [OpenWebIndex](http://openwebindex.eu) datasets across local and remote repositories. ## Quick Start ### One-Line Install (Recommended) ```bash curl -fsSL https://openwebindex.net/owilix/install.sh | sh ``` This script: - Installs [uv](https://docs.astral.sh/uv/) if not present - Creates a virtual environment at `~/.venv/owilix` - Installs the latest owilix - Adds to your PATH - Checks for config migrations ### Update ```bash OWILIX_UPGRADE=1 curl -fsSL https://openwebindex.net/owilix/install.sh | sh ``` If your terminal paste inserts `\|`, remove the backslash so the command contains a normal pipe (`|`). If the installer fails with a `python-http-irods-client` URL/dependency error, use the manual `uv` install shown below. ### Manual Install <details> <summary>Click to expand manual installation steps</summary> ```bash # Install uv if not already installed curl -LsSf https://astral.sh/uv/install.sh | sh # Create a virtual environment and install owilix uv venv --python 3.11 ~/.venv/owilix source ~/.venv/owilix/bin/activate uv pip install \ "python-http-irods-client @ git+https://opencode.it4i.eu/lexis-platform/data/python-http-irods-client.git@1.1.4" \ owilix \ --index-url https://opencode.it4i.eu/api/v4/projects/92/packages/pypi/simple \ --extra-index-url https://opencode.it4i.eu/api/v4/projects/107/packages/pypi/simple # Add to PATH (optional) echo 'export PATH="$HOME/.venv/owilix/bin:$PATH"' >> ~/.bashrc source ~/.bashrc ``` </details> ### Verify Installation ```bash owilix --version owilix remote doctor owilix remote ls all ``` After updates, check if config needs migration: `owilix config version` …