Skip to main content
Before you install AI-Implement, gather everything in the checklist below. Each item maps to a later setup step, so having them ready in advance makes the process significantly smoother.
1

Linear or Jira workspace

You need a Linear workspace where you can create labels. AI-Implement relies on the AI-Implement label to identify issues to process. You do not need admin access to the workspace — member-level access with the ability to create labels is sufficient.
2

GitHub organization or account, and a GitHub App you control

AI-Implement uses a GitHub App to authenticate workflow dispatches and to open pull requests under the app’s identity (which is what allows the /ai-implement comment trigger to work correctly). You need either:
  • A GitHub organization where you can create a GitHub App, or
  • A personal GitHub account with the ability to create a GitHub App
You will create the App during setup. See Create a GitHub App for the full walkthrough.
3

Somewhere to run the orchestrator

The orchestrator is a small Node.js service. You have two options:

Fly.io (recommended)

A Fly.io account lets you deploy the orchestrator as a managed app. It runs comfortably on a shared-cpu-1x machine with 256 MB of memory. See Deploy the orchestrator for instructions.

Any server running Node.js

You can run the orchestrator on any server or local machine that has Node.js 20 or later installed. The local development workflow is covered in Deploy the orchestrator.
4

A Claude provider

AI-Implement supports three ways to authenticate with Claude. You need at least one:
You configure the provider per target repo, not globally. If you are just getting started, an Anthropic API key is the simplest path.
5

Node.js 20 or later (for local development)

If you plan to run the orchestrator locally or contribute to the codebase, you need Node.js 20 or later installed on your machine. For production Fly.io deployments, Node.js is included in the build — you do not need to install it separately.

​
What’s next

Once you have everything above, work through the setup in order:

Create a GitHub App

Create and configure the GitHub App that AI-Implement uses to authenticate with GitHub and open PRs.

Deploy the orchestrator

Run the orchestrator locally or deploy it to Fly.io.