RescueRepo

Project originally built for the Bio X AI Hackathon. All about resurrecting old abandonware repos, and reducing the effort to get them up and running again.
Explore the docs »

View Demo · Report Bug · Request Feature

About The Project

A project built for resurrecting the countless abandonware repos littering GitHub. The goal is to make it easier to turn any repo, no matter how old, and turn it into a working GitHub Codespace.

https://github.com/matthew-mcateer/rescuerepo/assets/16986576/a480ab0e-aca1-4dcf-b7e0-7803a1931b0f

(back to top)

Built With

• Python
• NextJS
• OpenAI
• FastAPI
• React
• LangChain
• Supabase
• Docker
• GitHub Codespaces
• Postmark
• Celery
• RabbitMQ

(back to top)

Getting Started

For running this project locally, you can skip ahead to the Usage section.

To get a local copy up and running follow these simple steps:

Prerequisites

Here is a list of prerequisites you need to install before you can start using the examples in this repo.

• python 3.9 or later
• node 14.17.0 or later
• NPX 7.19.1 or later

Installation

1. First, Fork/Clone the repository.

Using HTTPS:

bash git clone https://github.com/matthew-mcateer/rescuerepo.git

or using the GitHub CLI:

bash gh repo clone matthew-mcateer/rescuerepo

1. Obtain the following API keys, and put them in a .env file in the api directory of the project. You can use the api/.env.example file as a template.

your SUPABASE_URL and SUPABASE_ANON_KEYk from your Supabase account

bash export SUPABASE_URL=<your-supabase-url> export SUPABASE_ANON_KEY=<your-supabase-anon-key>

your OpenAI API key

bash export OPENAI_API_KEY=<your-api-key>

your Anthropic API key

bash export ANTHROPIC_API_KEY=<your-api-key>

Your GitHub access token (classic) (make sure it has the codespaceand repo scopes):

bash export GH_ACCESS_TOKEN=<your-api-key>

Your CELERY_BROKER_URL:

bash export CELERY_BROKER_URL=<your-api-key>

Your POSTMARK_API_KEY:

bash export POSTMARK_API_KEY=<your-api-key>

1. Once you've added your API keys to the file api/.env, you can set the environment variable with the following command:

bash $ export $(cat api/.env | xargs)

1. Install the python dependencies.

bash $ python3.9 -m venv env $ source env/bin/activate (env)$ pip install -r requirements.txt

1. Make sure that you have npx installed, and install the frontend dependencies:

bash $ npm install -g npx $ npm install

1. (OPTIONAL): Start up the Celery worker in one terminal window (separate from the one in the next step):

bash $ (env)$ celery --app api.tasks worker --loglevel INFO

1. In a terminal window, run the NextJS front-end (which concurrently starts up the server-side FastAPI backend):

bash $ npm run dev 7. Navigate to http://localhost:3000 to see the app running in your browser.

1. (OPTIONAL): navigate to http://localhost:8000/api/docs to see the FastAPI docs.

(back to top)

Usage

In order to start this project locally, you'll need to start the frontend and then the backend.

First, follow the installation instructions above.

Navigate to http://localhost:3000 to see the app running in your browser.

Sign into GitHub, after which you'll be greeted with the below page.

You can enter in a GitHub repo URL of your choice. At the moment the default is https://github.com/lucidrains/progen.

Include with this information your GitHub Access token (make sure it has the repos and codespaces scopes enabled), as well as your email.

This will trigger the creation of the GitHub codespace.

If you navigate to the GitHub Codespaces Dashboard, you should see it being created (will resemble the below).

And if you load the codespace, you should be able to access it through VSCode or in the browser

Roadmap

The scope of this project is admittedly quite large, so we've broken it down into a few phases:

• ✅ Embedding Map of Bioinformatics tools ( view here, see the notebook for its creation here )
• ✅ Setting up a workflow for generating dev environments from an arbitrary repo
  • ✅ Creating a fork with a dockerfile, devcontainer.json, and anything else needed for a GitHub Codespace
  • ✅ Automatically Generated Dev Environments using GPT-4 (or Claude 100k)
  • 🚧 Get running environments built without error >50% of the time
• ✅ Automatically Refactoring Code using GPT-4 (or Claude 100k)
• 🚧 Translating languages using GPT-4 (or Claude 100k)
  • ✅ Nextflow-to-Flyte Translaton
  • 🚧 Nextflow-to-Snakemake Translaton
  • 🚧 Nextflow-to-Redun Translaton
  • 🚧 Nextflow-to-CWL Translaton
  • 🚧 MATLAB-to-Python Translaton
• 🚧 Improving the UI/UX of the above.

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Contact

Matthew Mcateer (Author) - @MatthewMcAteer0 - bioml@5cubelabs.us

Project Link: https://github.com/matthew-mcateer/rescuerepo

(back to top)

Acknowledgments

We'd like to thank everyone for their contributions to this project and the hackathon.

We would also like to thank the organizers of the Bio X AI Hackathon for putting on such a great event.

• Chelsea Voss - OpenAI
• Michael Retchin - Nucleate
• Tess van Stekelenburg - Lux Capital
• Niccolo Zanchelli - OpenBioML
• Katie Link - HuggingFace
• Alfredo Andere - LatchBio
• Anton Troynikov - Chroma
• Lan Jiang - Lux Capital
• Joshua Meier - AbSci

(back to top)