Skip to main content

Installation

Get drep installed on your system in under a minute. Choose from PyPI, Homebrew, Docker, or source installation.

Prerequisites

System Requirements

  • Python: 3.10 or higher
  • Git: For scanning repositories
  • LLM Backend: LM Studio, Ollama, llama.cpp, or OpenAI-compatible endpoint (see LLM Setup Guide)

Via PyPI

Install drep using pip:

bash
pip install drep-ai

Package Name Note

The PyPI package is named drep-ai (the name drep was already taken by a bioinformatics tool). After installation, the command-line tool is still drep.

Verify the installation:

bash
drep --help

Via Homebrew (macOS/Linux)

Install drep using Homebrew:

bash
brew tap slb350/drep
brew install drep-ai

Verify the installation:

bash
drep --help

Homebrew Benefits

Homebrew automatically manages dependencies and keeps drep up to date with brew upgrade drep-ai. Great for macOS and Linux users who prefer package managers.

From Source

For contributors or those who want the latest development version:

bash
git clone https://github.com/slb350/drep.git
cd drep
pip install -e ".[dev]"

The -e flag installs in editable mode, and [dev] includes development dependencies (pytest, black, ruff, mypy).

Via Docker

Pull the official Docker image from GitHub Container Registry:

bash
docker pull ghcr.io/slb350/drep:latest

Docker Compose with Ollama

For a complete setup with Ollama as the LLM backend:

yaml
version: '3.8'
services:
  drep:
    image: ghcr.io/slb350/drep:latest
    ports:
      - "8000:8000"
    volumes:
      - ./config.yaml:/app/config.yaml
      - ./data:/app/data
    environment:
      - DREP_LLM_ENDPOINT=http://ollama:11434
    depends_on:
      - ollama

  ollama:
    image: ollama/ollama:latest
    ports:
      - "11434:11434"
    volumes:
      - ollama_data:/root/.ollama

volumes:
  ollama_data:

Start the services:

bash
docker compose up -d

Next Steps

Now that drep is installed, you're ready to:

  1. Set up a local LLM backend (LM Studio, Ollama, or llama.cpp)
  2. Follow the Quick Start tutorial to configure and run your first scan
  3. Learn about configuration options for advanced setup

Installation Complete!

Continue to the Quick Start guide to configure drep and run your first repository scan.