Installation

Quick Installation

The fastest way to install Grok-X is using the one-line installer:

Run the installer

Execute the following command in your terminal:

bash <(curl -fsSL https://raw.githubusercontent.com/stat-guy/grok-x/main/install.sh)

The installer will:

Verify the installation

Confirm the installation was successful by running:

~/.claude/skills/grok-x/.venv/bin/python3 ~/.claude/skills/grok-x/grok_x.py --help

You should see the help output displaying available commands and options.

Configure your API key

Add your xAI API key to complete the setup. See the Configuration guide for details.

The installer requires either curl or wget and will automatically detect which is available on your system.

If you prefer to install manually or need more control over the process:

Clone the skill repository

git clone https://github.com/stat-guy/grok-x.git ~/.claude/skills/grok-x

Create a virtual environment

python3 -m venv ~/.claude/skills/grok-x/.venv

Install dependencies

~/.claude/skills/grok-x/.venv/bin/pip install openai

Grok-X uses the OpenAI Python client library to communicate with the xAI API.

Verify the installation

~/.claude/skills/grok-x/.venv/bin/python3 ~/.claude/skills/grok-x/grok_x.py --help

If you encounter a python3: command not found error, ensure Python 3.9 or later is installed and available in your PATH.

The skill directory at ~/.claude/skills/grok-x can be relocated if needed, but you’ll need to update any absolute paths in your configuration.

With Grok-X installed, proceed to Configuration to add your xAI API key and start using the skill.