# Installation

## 🔧 Prerequisites

Before installing ContextGem, ensure you have:

* Python 3.11-3.14
* [uv](https://github.com/astral-sh/uv) or pip

## 📦 Installation Methods

### From PyPI

Using [uv](https://github.com/astral-sh/uv) (recommended):

```bash
uv add contextgem
```

Or using pip:

```bash
pip install -U contextgem
```

### Development Installation

For development, clone the repository and use uv:

```bash
git clone https://github.com/shcherbak-ai/contextgem.git
cd contextgem

# Install uv if you don't have it:
# https://docs.astral.sh/uv/getting-started/installation/

# Install the dependencies, including the development dependency groups
uv sync --all-groups
```

## ✅ Verifying Installation

To verify that ContextGem is installed correctly, run in your project:

```bash
uv run python -c "import contextgem; print(contextgem.__version__)"
```

Or, if you installed it with pip, in the environment you installed it in:

```bash
python -c "import contextgem; print(contextgem.__version__)"
```