System Requirements Leave feedback

Note

GroupDocs.Search for Python via .NET ships as a self-contained wheel that bundles the .NET runtime it needs. No Microsoft Office, third-party document software, .NET install or Mono install is required. On Linux and macOS a few system packages are needed; see Platform Dependencies. To install the library, follow the steps in the Installation guide.

GroupDocs.Search for Python via .NET runs on Windows, Linux, and macOS. The package ships as a platform-specific .whl, and pip picks the correct one automatically.

• Microsoft Windows 10 (x64)
• Microsoft Windows 11 (x64)
• Microsoft Windows Server 2016, 2019, 2022 and 2025

The Windows wheel is 64-bit only: use a 64-bit Python.

• Any x86-64 distribution with glibc 2.27 or newer - for example Ubuntu 18.04+, Debian 10+, RHEL 8+. The embedded .NET runtime needs glibc 2.27, and the wheel’s manylinux_2_27_x86_64 tag says so, so pip refuses an older system.

• macOS 13 (Ventura) and later - Intel and Apple Silicon (M-series). The wheels are tagged macosx_13_0_*: the ONNX Runtime library they bundle requires macOS 13. Microsoft supports .NET 10 on macOS 14 and later.

GroupDocs.Search for Python via .NET supports Python 3.5 through 3.14, 64-bit. The wheel uses the py3-none-{platform} tag, meaning it works with any Python 3.x version in that range without per-version rebuilds.

GroupDocs.Search for Python via .NET is distributed via PyPI and the GroupDocs Releases website:

pip install groupdocs-search-net

Until PyPI carries the 26.10 wheels, install a wheel downloaded from the releases website, as described on the Installation page. One wheel is published per platform:

pip 20.3 or newer picks the right wheel for your platform; older versions do not recognise these tags, so upgrade with python -m pip install --upgrade pip (on Python 3.5, python -m pip install "pip==20.3.4"). On an Intel Mac, a Python built against a pre-11 macOS SDK reports its system as macOS 10.16 - there use pip 24.1 or newer, or run SYSTEM_VERSION_COMPAT=0 pip install groupdocs-search-net.

Install ICU and libgdiplus:

sudo apt-get update
sudo apt-get install -y libicu-dev libgdiplus

What each package is for, measured on the 26.10 engine:

• ICU (libicu-dev, any version your distribution ships) - required. The .NET runtime needs it for text processing: without it, the first call into the engine aborts the Python process with Couldn't find a valid ICU package. Do not set DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=1 to work around it.
• libgdiplus - presentations. Without it, ODP and PPT files are left out of the index, and the index’s error_occurred event reports The type initializer for 'Gdip' threw an exception or a NullReferenceException. Every other format indexes without it, PPTX included.

No fonts are needed: indexing and searching on an image with ICU alone, without fontconfig or any font files, gives the same results.

Install mono-libgdiplus using Homebrew, for presentations, as on Linux:

brew install mono-libgdiplus

No extra dependencies - the wheel is self-contained.

Recognizing text in images (OCR) requires an OCR engine connected through an OCR connector; see OCR support.

• The first call into the engine takes about a second.
• On Windows, when a license is applied, the first call in a process takes 15-30 seconds: that is the engine’s license check, which runs once per process. Keep one process for many operations.

Any editor or IDE that runs CPython works, for example Visual Studio Code, PyCharm and Jupyter. Type stubs (.pyi) ship in the wheel, so editors complete class and member names.