Installation Guide

Time: 15-30 minutes total (including all installations)

Result: Working Skill Seekers v3.1.0 installation ready to create AI skills

Prerequisites

Before starting, you need:

  • A computer (macOS, Linux, or Windows with WSL)
  • Internet connection
  • 30 minutes of time

The easiest way to install Skill Seekers is through PyPI:

# Install base package
pip install skill-seekers

# Or install with specific LLM platform support
pip install skill-seekers[gemini]  # For Google Gemini
pip install skill-seekers[openai]  # For OpenAI ChatGPT
pip install skill-seekers[all]     # For all platforms

Verify installation:

skill-seekers --version
# Should show: skill-seekers 3.1.0 or higher

Method 2: Install with uv (Fastest)

uv is a fast Python package manager:

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install Skill Seekers
uv tool install skill-seekers

# Verify
skill-seekers --version

Method 3: Install from Source

For development or the latest features:

Step 1: Install Python (5 minutes)

Check if You Already Have Python

python3 --version

✅ If you see: Python 3.10.x or higher → Skip to Step 2!

❌ If not installed:

macOS:

# Install Homebrew (if not installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Python
brew install python3

Linux (Ubuntu/Debian):

sudo apt update
sudo apt install python3 python3-pip

Windows:

  1. Download Python from: https://www.python.org/downloads/
  2. Run installer
  3. IMPORTANT: Check “Add Python to PATH” during installation

Step 2: Install Git (3 minutes)

git --version

✅ If you see: git version 2.x.x → Skip to Step 3!

❌ If not installed:

macOS:

brew install git

Linux:

sudo apt install git

Windows: Download from: https://git-scm.com/download/win

Step 3: Clone and Install (2 minutes)

# Create Projects directory
mkdir -p ~/Projects
cd ~/Projects

# Clone repository
git clone https://github.com/yusufkaraaslan/Skill_Seekers.git
cd Skill_Seekers

# Install in development mode
pip install -e .

# Or install with all dependencies
pip install -e ".[all]"

Verify installation:

skill-seekers --version

Claude Code enables free local AI enhancement (uses your Claude Max subscription):

# Install via Homebrew (macOS)
brew install claude

# Or via npm
npm install -g @anthropic/claude-code

# Verify
claude --version

Why install Claude Code?

  • ✅ FREE enhancement (no API costs)
  • ✅ Local processing (faster, more private)
  • ✅ Same quality as API mode

Without Claude Code, you can still:

  • ✅ Scrape documentation perfectly
  • ✅ Package skills for all platforms
  • ✅ Use API enhancement (~$0.15-$0.30/skill)

Set Up API Keys (Optional)

For API-based enhancement or upload, set up your API key:

For Claude (Anthropic)

export ANTHROPIC_API_KEY="your-api-key-here"

For Google Gemini

export GOOGLE_API_KEY="your-api-key-here"

For OpenAI

export OPENAI_API_KEY="your-api-key-here"

Make it permanent (optional):

Add the export command to your shell profile (~/.bashrc, ~/.zshrc, or ~/.bash_profile):

echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.bashrc
source ~/.bashrc

Verify Your Setup

Run the built-in check:

skill-seekers doctor

This will verify:

  • ✅ Python version
  • ✅ Skill Seekers installation
  • ✅ Git availability
  • ✅ Optional: Claude Code
  • ✅ Optional: API keys

Docker Installation (Alternative)

Run Skill Seekers without installing Python:

# Pull the image
docker pull skillseekers/skill-seekers:latest

# Run
docker run -v $(pwd):/data skillseekers/skill-seekers:latest \
  create https://react.dev --target claude --output /data/react/

See Docker Deployment for details.

Troubleshooting

”command not found: skill-seekers”

Make sure pip’s bin directory is in your PATH:

# Find where pip installed it
pip show skill-seekers

# Add to PATH (adjust path as needed)
export PATH="$HOME/.local/bin:$PATH"

“No module named ‘skill_seekers’”

Install using pip instead of python:

pip install -e .

Permission errors

Use --user flag:

pip install --user skill-seekers

macOS: “claude command not found”

Claude Code may not be in your PATH. Add it:

export PATH="$HOME/.claude/bin:$PATH"

Next Steps