CocoIndex installation

pip install cocoindex, start a pgvector-enabled Postgres in Docker, and verify the system requirements (Python 3.11 to 3.13 on macOS, Linux, or Windows).

Time

~3 minutes

Language

Python 3.11+

Version

v 0.3.37

Last reviewed

Feb 15, 2026

🖥️ 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

🐍 Install Python and Pip

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

1. Install Python. We support Python 3.11 to 3.13.
2. Install pip - a Python package installer

🌴 Install CocoIndex

pip install -U cocoindex

📦 Install Postgres

You can skip this step if you already have a Postgres database with pgvector extension installed.

If you don’t have a Postgres database:

1. Install Docker Compose 🐳.
2. Start a Postgres SQL database for cocoindex using our docker compose config:

docker compose -f <(curl -L https://raw.githubusercontent.com/cocoindex-io/cocoindex/refs/heads/main/dev/postgres.yaml) up -d

🤖 Install Claude Code Skill (Optional)

If you’re using Claude Code, you can install the CocoIndex skill for enhanced development support. Run these commands in Claude Code:

/plugin marketplace add cocoindex-io/cocoindex-claude
/plugin install cocoindex-skills@cocoindex

This provides specialized CocoIndex knowledge and workflow support within Claude Code.

🎉 All set

You can now start using CocoIndex.