Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/guillermoscript/repo-assistant
AI Github assistant for your repo. Your proactive GitHub bot that auto-detects duplicates using OpenAI embeddings and Supabase magic!
https://github.com/guillermoscript/repo-assistant
ai assistant bot duplicate-issues github github-bot gpt-4 issue-management llm natural-language-processing openai openai-embeddings rag supabase typescript vector-similarity
Last synced: 11 days ago
JSON representation
AI Github assistant for your repo. Your proactive GitHub bot that auto-detects duplicates using OpenAI embeddings and Supabase magic!
- Host: GitHub
- URL: https://github.com/guillermoscript/repo-assistant
- Owner: guillermoscript
- License: isc
- Created: 2024-01-04T01:19:12.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-02-11T18:13:58.000Z (9 months ago)
- Last Synced: 2024-08-01T08:10:17.214Z (3 months ago)
- Topics: ai, assistant, bot, duplicate-issues, github, github-bot, gpt-4, issue-management, llm, natural-language-processing, openai, openai-embeddings, rag, supabase, typescript, vector-similarity
- Language: TypeScript
- Homepage: https://guillermoscript.github.io/blog/posts/repo-assistant-ai
- Size: 371 KB
- Stars: 21
- Watchers: 1
- Forks: 2
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome - guillermoscript/repo-assistant - AI Github assistant for your repo. Your proactive GitHub bot that auto-detects duplicates using OpenAI embeddings and Supabase magic! (TypeScript)
README
# Repo Assistant AI
Welcome to Repo Assistant AI! 🎉 This GitHub App is built with [Probot](https://github.com/probot/probot) and integrates [OpenAI](https://openai.com/) to help maintainers identify and label duplicate issues automatically. Using the power of OpenAI's embeddings and Supabase's database, this app streamlines your workflow by finding similarities between issues.
## Table of Contents
- [Bot Usage](#bot-usage)
- [Fetures](#features)
- [Getting Started](#getting-started)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Configuration](#configuration)
- [Docker Deployment](#docker-deployment)
- [Sync Existing Issues](#sync-existing-issues)
- [Examples](#examples)
- [Gallery](#gallery)
- [Contributing](#contributing)
- [License](#license)
- [Setting Up Supabase](#setting-up-supabase)
- [Setting Up OpenAI](#setting-up-openai)
- [Deploying the App](#deploying-the-app)
## Bot Usage
Currently, Repo Assistant AI is in its initial stages and operates locally. In the future, it will be ready for server deployment and will work across various repositories. For now, follow the steps below to get started, set up your own instance, and test it on your chosen repositories.
## Features
- [x] Sync existing issues
- [x] Find duplicate issues
- [x] Label duplicate issues
- [x] Work across repositories
- [x] Add labels to opened issues without labels, and a brief description on why it was labeled
- [ ] Deploy to server
Those are the main features that I can think of right now. If you have any other ideas, feel free to open an issue or submit a pull request!
## Getting Started
### Prerequisites
Before you start, make sure you have:
- A GitHub account
- A Supabase account
- An OpenAI account
- node v18 or higher
### Installation
1. Clone the repository to your local machine:
```sh
git clone https://github.com/your-username/repo-assistant-ai.git
cd repo-assistant-ai
```
2. Install the dependencies:
```sh
npm install
```
3. Build the TypeScript files:
```sh
npm run build
```
4. Run the bot:
```sh
npm start
```
5. Go ahead and click the Register a GitHub App button.
6. Next, you'll get to decide on an app name that isn't already taken. Note: if you see a message "Name is already in use" although no such app exists, it means that a GitHub organization with that name exists and cannot be used as an app name.
7. After registering your GitHub App, you'll be redirected to install the app on any repositories. At the same time, you can check your local .env and notice it will be populated with values GitHub sends us in the course of that redirect.
8. Restart the server in your terminal (press ctrl + c to stop the server)
9. Install the app on a test repository.
10. Try creating an issue on the repository you installed the app on. You should see a comment from the bot on the issue.
11. You're all set!
if you want to sync existing issues, you can run the following command:
```sh
npm run sync --user= --repo=
```
Make sure to have the `.env` file set up with Supabase, OpenAI, and GitHub tokens before running the command.
### Configuration
1. Create a `.env` file in the root directory of your project and fill in your API keys and other environment variables:
```env
# Supabase
SUPABASE_URL=your-supabase-url
SUPABASE_ANON_KEY=your-supabase-key
# OpenAI
OPENAI_API_KEY=your-openai-api-key
# GitHub
GITHUB_TOKEN=your-github-token
APP_ID=your-app-id
PRIVATE_KEY=your-pem-value
```
2. Set up your Supabase database by following the instructions in the [Setting Up Supabase](#setting-up-supabase) section below.
3. Set up your OpenAI API key by following the instructions in the [Setting Up OpenAI](#setting-up-openai) section below.
4. Run the bot:
```sh
npm start
```
## Docker Deployment
To deploy the app using Docker, follow these steps:
1. Build the Docker container:
```sh
docker build -t repo-assistant .
```
2. Start the container with the necessary environment variables:
```sh
docker run -e APP_ID= -e PRIVATE_KEY= repo-assistant
```
## Sync Existing Issues
To synchronize existing issues, you'll need a GitHub token with repository access:
1. Generate a GitHub token by visiting [github.com/settings/tokens](https://github.com/settings/tokens).
2. Run the sync command with your username and repository:
```sh
npm run sync --user= --repo=
```
Make sure to have the `.env` file set up with Supabase, OpenAI, and GitHub tokens before running the command.
## Examples
Duplicate Issue: [here](https://github.com/guillermoscript/repo-assistant/issues/57)
Original Issue: [here](https://github.com/guillermoscript/repo-assistant/issues/13)
New Unique Issue With labels added: [here](https://github.com/guillermoscript/repo-assistant/issues/53)
## Gallery
## Contributing
Got ideas on how to make Repo Assistant AI even better? Want to report a bug? Feel free to open an issue or submit a pull request! Check out our [Contributing Guide](CONTRIBUTING.md) for more information on how to get involved.
## License
Repo Assistant AI is open source software [licensed as ISC](LICENSE) © 2024 guillermoscript.
## Setting Up Supabase
To use Supabase, follow these steps:
1. Create an account at [supabase.io](https://supabase.io/).
2. Once logged in, create a new project.
3. Navigate to the SQL editor in your project's dashboard and run the following SQL commands to set up the necessary tables and functions:
```sql
-- Enable the pgvector extension to work with embedding vectors
create extension vector;
create table
public.documents (
id bigserial,
content text null,
metadata jsonb null,
embedding public.vector null,
created_at timestamp with time zone null default current_timestamp,
issue_number bigint null,
issue_id bigint null,
repo_id bigint null,
constraint documents_pkey primary key (id)
) tablespace pg_default;
create or replace function match_documents (
query_embedding vector(1536),
match_count int default null,
filter jsonb DEFAULT '{}',
match_threshold double precision DEFAULT NULL::double precision
) returns table (
id bigint,
content text,
metadata jsonb,
similarity float -- This column expects a float value
)
language plpgsql
as $$
begin
return query
select
documents.id,
documents.content,
documents.metadata,
1 - (documents.embedding <=> query_embedding) as similarity -- Ensure this is a float
from documents
where documents.metadata @> filter
and (match_threshold is null or (1 - (documents.embedding <=> query_embedding)) > match_threshold)
order by documents.embedding <=> query_embedding
limit match_count;
end;
$$;
```
4. Don't forget to add your Supabase URL and ANON KEY to the `.env` file as shown in the [Configuration](#configuration) section.
## Setting Up OpenAI
To set up OpenAI:
1. Create an account at [openai.com](https://platform.openai.com/docs/quickstart?context=node).
2. Navigate to the API section and generate a new API key.
3. Add your OpenAI API key to the `.env` file as described in the [Configuration](#configuration) section.
We're excited to have you try out Repo Assistant AI! If you encounter any issues or have questions, don't hesitate to reach out.
## Deploying the App
To deploy the app, follow these from the probot docs [here](https://probot.github.io/docs/deployment/).
As of now, the app is not ready for deployment as GPT is quite expensive to run. However, if you want to deploy it, you can follow the instructions in the link above.