Installation Guide

Get CodeFlow Engine up and running in minutes. Choose your preferred installation method.

Quick Install (Recommended)

Use our automated installation script for the fastest setup:

curl -fsSL https://raw.githubusercontent.com/JustAGhosT/codeflow-engine/main/install.sh | bash

Docker Installation

Run CodeFlow Engine in a containerized environment:

# Pull the image
docker pull ghcr.io/justaghost/codeflow-engine:latest
# Run the container
docker run -p 8000:8000 ghcr.io/justaghost/codeflow-engine:latest

Python Installation

Install from PyPI using pip:

pip install codeflow-engine
# Or using Poetry
poetry add codeflow-engine

GitHub App Setup

Configure CodeFlow Engine as a GitHub App:

  1. Create a new GitHub App in your organization settings
  2. Set the webhook URL to your CodeFlow Engine instance
  3. Configure the required permissions (read/write access to PRs and issues)
  4. Install the app on your repositories
  5. Configure environment variables in your CodeFlow Engine instance

Need Help?

Check out our documentation or open an issue on GitHub.

© 2026 CodeFlow Engine. All rights reserved.