Skip to content

Commit

Permalink
Update README.md re order running app
Browse files Browse the repository at this point in the history
  • Loading branch information
JeremiahPetersen authored Mar 10, 2024
1 parent f3f9802 commit be63189
Showing 1 changed file with 13 additions and 12 deletions.
25 changes: 13 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,19 @@

RepoToText is a web app that scrapes a GitHub repository and converts its files into a single organized .txt. It allows you to enter the URL of a GitHub repository and an optional documentation URL (the doc info will append to the top of the .txt). The app retrieves the contents of the repository, including all files and directories, and also fetches the documentation from the provided URL and includes it in a single organized text file. The .txt file will be saved in the /data folder with user + repo + timestamp info. This file can then be uploaded to (GPT-4, Claude Opus, etc) and you can use the chatbot to interact with the entire GitHub repo.

## Running the Application with Docker

To run the application using Docker, follow these steps:

1. Clone the repository.
2. Set up the environment variable `GITHUB_API_KEY` in the `.env` file.
3. Build the Docker images with `docker compose build`.
4. Start the containers with `docker compose up`.
5. Access the application (http://localhost:3000) in a web browser and enter the GitHub repository URL and documentation URL (if available).
6. Choose All files or choose specific file types.
7. Click the "Submit" button to initiate the scraping process. The converted text will be displayed in the output area, and it will also be saved in the /data folder.
8. You can also click the "Copy Text" button to copy the generated text to the clipboard.

### Environment Configuration
Add your GitHub API Key in the .env file

Expand Down Expand Up @@ -40,18 +53,6 @@ FolderToText.py is a script that allows you to turn a local folder, or local fil
- GitHub API: PyGithub library
- Additional Python libraries: beautifulsoup4, requests, flask_cors, retry

## Running the Application with Docker

To run the application using Docker, follow these steps:

1. Clone the repository.
2. Set up the environment variable `GITHUB_API_KEY` in the `.env` file.
3. Build the Docker images with `docker compose build`.
4. Start the containers with `docker compose up`.
5. Access the application (http://localhost:3000) in a web browser and enter the GitHub repository URL and documentation URL (if available).
6. Choose All files or choose specific file types.
7. Click the "Submit" button to initiate the scraping process. The converted text will be displayed in the output area, and it will also be saved in the /data folder.
8. You can also click the "Copy Text" button to copy the generated text to the clipboard.

## TODO

Expand Down

0 comments on commit be63189

Please sign in to comment.