> ## Documentation Index
> Fetch the complete documentation index at: https://vecgrep.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install, update, and uninstall VecGrep

## Requirements

* Python 3.12
* [uv](https://docs.astral.sh/uv/) (recommended) or pip
* [Claude Code](https://claude.ai/claude-code)

<Note>
  Python 3.12 is required — `tree-sitter-languages` does not yet have wheels for Python 3.13+.
</Note>

## Install

<CodeGroup>
  ```bash uv (recommended) theme={null}
  uv tool install --python 3.12 vecgrep
  ```

  ```bash pip theme={null}
  pip install vecgrep
  ```
</CodeGroup>

## Register with Claude Code

Run once — works for every project:

```bash theme={null}
claude mcp add --scope user vecgrep -- vecgrep
```

This registers VecGrep in your user config (`~/.claude.json`) so it's available globally across all projects. Starts instantly — no download delay on Claude Code launch.

## Update

<CodeGroup>
  ```bash uv theme={null}
  uv tool upgrade vecgrep
  ```

  ```bash pip theme={null}
  pip install --upgrade vecgrep
  ```
</CodeGroup>

To install a specific version:

<CodeGroup>
  ```bash uv theme={null}
  uv tool install --python 3.12 vecgrep==2.0.0
  ```

  ```bash pip theme={null}
  pip install vecgrep==2.0.0
  ```
</CodeGroup>

After upgrading, restart Claude Code to pick up the new version.

## Uninstall

<CodeGroup>
  ```bash uv theme={null}
  uv tool uninstall vecgrep
  ```

  ```bash pip theme={null}
  pip uninstall vecgrep
  ```
</CodeGroup>

Then remove the MCP registration from Claude Code:

```bash theme={null}
claude mcp remove vecgrep
```

To also wipe all indexes (vector + graph) stored on disk, delete the VecGrep data directory:

```
~/.vecgrep/
```

## Dependencies (v2.0.0+)

VecGrep v2.0.0 adds `networkx>=3.2` and `tree-sitter==0.21.3` (pinned) for the knowledge graph index. Both are installed automatically — no extra steps required.