> ## Documentation Index
> Fetch the complete documentation index at: https://docs.graphify.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Installation
> Install, upgrade, and register the Graphify skill on macOS, Linux, and Windows.
## Prerequisites
| Requirement | Check |
| ------------------------------------------ | ----------------------------------------------- |
| Python 3.10 or later | `python3 --version` or `python --version` |
| uv or pipx | `uv --version` or `pipx --version` |
| A coding assistant, for the skill workflow | [Choose an integration](/integrations/overview) |
The standalone CLI works without an assistant. Code-only extraction does not require an API key.
## Install the package
```bash uv theme={null}
uv tool install graphifyy
```
```bash pipx theme={null}
pipx install graphifyy
```
```bash Python environment theme={null}
python3 -m venv .venv
.venv/bin/python -m pip install graphifyy
```
On Windows, a virtual environment’s executable is `.venv\Scripts\python.exe`. uv and pipx manage the environment for you.
The official PyPI package is `graphifyy`. Other similarly named packages are not the Graphify Labs package.
## Register the skill
```bash theme={null}
graphify install
graphify install --platform codex
```
The first command detects an assistant; the second targets one explicitly. Run the specific command for each assistant you use. Use `--project` when you want the registration committed with a repository:
```bash theme={null}
graphify install --project --platform codex
```
Read the installer’s list of files before committing them. Project and user registrations live in different locations.
## Optional capabilities
Install only the extras your workflow needs. Quote bracketed names in zsh.
| Capability | uv installation |
| -------------------- | ---------------------------------------- |
| MCP server | `uv tool install "graphifyy[mcp]"` |
| File watching | `uv tool install "graphifyy[watch]"` |
| PDFs | `uv tool install "graphifyy[pdf]"` |
| SQL parsing | `uv tool install "graphifyy[sql]"` |
| Terraform | `uv tool install "graphifyy[terraform]"` |
| Office documents | `uv tool install "graphifyy[office]"` |
| Local Ollama backend | `uv tool install "graphifyy[ollama]"` |
| Leiden clustering | `uv tool install "graphifyy[leiden]"` |
Combine extras, for example `uv tool install "graphifyy[mcp,watch]"`. If uv reports an existing installation, use its `--reinstall` option to replace that tool environment with the requested extras.
## Upgrade
```bash theme={null}
uv tool upgrade graphifyy
graphify install --platform codex
```
Re-run registration for the assistants you use so their skill files match the package. If you installed git hooks, run `graphify hook install` again after moving or reinstalling the Python environment.
## Command not found
```bash theme={null}
uv tool update-shell
```
Then open a new terminal. With pipx, run `pipx ensurepath`. If an MCP client cannot find Graphify, use an absolute executable path in its configuration.
## Remove a registration
```bash theme={null}
graphify uninstall --project --platform codex
```
`graphify uninstall` removes user registrations across platforms. The optional `--purge` flag also deletes `graphify-out/`; omit it to preserve your graph.