---
title: CocoIndex *installation*
description: >
  Install CocoIndex with pip, uv, or Poetry, and check system requirements —
  Python 3.11 to 3.13 on macOS, Linux, or Windows.
meta:
  time: ~3 minutes
  language: Python 3.11+
---
## Install Python and pip

To follow the steps in this guide, you'll need:

1. Install [Python](https://wiki.python.org/moin/BeginnersGuide(2f)Download.html). We support Python 3.11 to 3.13.
2. Install [pip](https://pip.pypa.io/en/stable/installation/) - a Python package installer

## Install CocoIndex

### Using pip

```sh
pip install -U cocoindex
```

### Using uv

```sh
uv add cocoindex
```

### Using Poetry

```sh
poetry add cocoindex
```

Or specify in `pyproject.toml`:

```toml
[tool.poetry.dependencies]
cocoindex = { version = "^1.0" }
```

## System requirements

CocoIndex is supported on the following operating systems:

- **macOS**: 10.12+ on x86_64, 11.0+ on arm64
- **Linux**: x86_64 or arm64, glibc 2.28+ (e.g., Debian 10+, Ubuntu 18.10+, Fedora 29+, CentOS/RHEL 8+)
- **Windows**: 10+ on x86_64
