Alby Freepilot

A GitHub bot that implements issues by reading repository context, understanding requirements, and creating pull requests with the necessary code changes. The bot is currently triggered through a web interface where users can paste GitHub issue URLs.

Try it now

Development

Prerequisites

1. Install Goose
2. NodeJS and Yarn
3. A dedicated Github account to run the bot (similar to freepilot-bot)

Local Git Setup

Option 1: docker

See docker instructions at the bottom of this file.

Option 2: local

NOTE: you are trusting the agent to run in "auto" mode which is potentially dangerous.

See this gist for setting up multiple SSH keys and this gist for setting up multiple git profiles

The WORK_DIR should have a .gitconfig file so that all work done by the bot is using a separate profile.

Backend

cd backend

Setup your environment variables:

cp backend/.env.example backend/.env

Run the app

yarn install
yarn start

Frontend

cd frontend
yarn install
yarn dev

Docker

Make sure the SSH_PRIVATE_KEY_BASE64 env variable is in base64 format: base64 -w 0 id_rsa > id_rsa.b64

$ docker build . -t freepilot-local --progress=plain
$ docker run -v $(pwd)/.data/docker:/data -e WORK_DIR='/data' -e DATABASE_URL='file:/data/freepilot.db' -e GITHUB_TOKEN="ghp_..." -e OPENROUTER_API_KEY="sk-or-v1-..." -e SSH_PRIVATE_KEY_BASE64="XXXXXXX" -e SSH_PUBLIC_KEY="XXXXXXX" -p 3001:3001 freepilot-local