gh-echo


Namegh-echo JSON
Version 0.2.0 PyPI version JSON
download
home_pagehttps://pypi.org/project/gh-echo/o
SummaryA command-line tool built to obtain in-depth, actionable information about GitHub repositories.
upload_time2024-09-19 18:49:48
maintainerNone
docs_urlNone
authorAryan Khurana
requires_python<4.0,>=3.9
licenseMIT
keywords github genai python3 cli
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <p align="center">
  <img width="100%" src="https://github.com/AryanK1511/github-echo/blob/main/assets/logo.png?raw=true"><br /><br />
  <strong>A command-line tool built to obtain in-depth, actionable information about GitHub repositories that is often challenging to decipher manually</strong><br /><br />
</p>

<p align="center">
  <a href="https://python.org">
    <img src="https://img.shields.io/badge/Python-3.11-blue?logo=python&logoColor=white" alt="Python Version">
  </a>
  <a href="https://pypi.org/project/gh-echo/">
    <img src="https://img.shields.io/pypi/v/gh-echo?color=blue&label=pypi%20package" alt="PyPI Version">
  </a>
  <a href="https://github.com/AryanK1511/github-echo">
    <img src="https://img.shields.io/github/stars/AryanK1511/github-echo?style=social" alt="GitHub Stars">
  </a>
  <a href="https://github.com/AryanK1511/github-echo/graphs/contributors">
    <img src="https://img.shields.io/github/contributors/AryanK1511/github-echo" alt="GitHub Contributors">
  </a>
  <a href="https://opensource.org/licenses/MIT">
    <img src="https://img.shields.io/github/license/AryanK1511/github-echo" alt="License">
  </a>
  <a href="https://github.com/AryanK1511/github-echo/issues">
    <img src="https://img.shields.io/github/issues/AryanK1511/github-echo" alt="GitHub Issues">
  </a>
  <a href="https://youtu.be/bTbETpn7C9I">
    <img src="https://img.shields.io/badge/Watch-Demo-red?logo=youtube" alt="Watch Demo">
  </a>
</p>

## Table of Contents

- [Usage](#usage)
- [Installing via PyPi](#installing-via-pypi)
  - [Prerequisites](#prerequisites)
  - [Setup Instructions](#setup-instructions)
    - [For macOS/Linux](#for-macoslinux)
    - [For Windows](#for-windows)
- [Running the Tool Locally](#running-the-tool-locally)
  - [Prerequisites](#prerequisites-1)
  - [Setup Instructions](#setup-instructions-1)
    - [1. Clone the Repository](#1-clone-the-repository)
    - [2. Set Up Environment Variables](#2-set-up-environment-variables)
    - [3. Install Required Dependencies](#3-install-required-dependencies)
    - [4. Activate the Virtual Environment](#4-activate-the-virtual-environment)
    - [5. Running the CLI Tool Locally](#5-running-the-cli-tool-locally)
      - [On Windows](#on-windows)
      - [On macOS and Linux](#on-macos-and-linux)
- [Running Using Docker](#running-using-docker)
  - [On Windows](#on-windows-1)
  - [On macOS and Linux](#on-macos-and-linux-1)
- [Troubleshooting](#troubleshooting)
- [Further Usage Instructions](#further-usage-instructions)
  - [Arguments](#arguments)
  - [Options](#options)
- [More about `github-echo`](#more-about-github-echo)
  - [Information drawn from the GitHub API](#information-drawn-from-the-github-api)
  - [Gemini GenAI Integration](#gemini-genai-integration)
- [Contributing](#contributing)
- [License](#license)
- [Author](#author)

## Usage

You can use this tool in two ways:

1. **[Install via PyPi](#installing-via-pypi)**: Quickly set up the tool with a simple `pip install`.
2. **[Run Locally](#running-the-tool-locally)**: Clone the repository and run it directly on your machine for development or testing.

## Installing via `PyPi`

### Prerequisites

1. **Python3+**: Ensure `Python3` is installed on your system. You can download it from [python.org](https://www.python.org/downloads/).

### Setup Instructions

1. Open a terminal or command prompt.

2. Install the tool via PyPi:

   ```bash
   pip install gh-echo
   ```

3. Once installed, you need to set the required environment variables in your shell configuration. Here are the steps for different systems:

#### For macOS/Linux

- Open your terminal.
- Add the environment variables to your shell configuration file (e.g., `.bashrc`, `.zshrc`, etc.)

  ```bash
  export GOOGLE_GEMINI_API_KEY='Your Google Gemini API Key'
  export GITHUB_API_TOKEN='Your GitHub API Token'
  export GITHUB_API_VERSION='2022-11-28'
  ```

- Run `source ~/.bashrc` (or `source ~/.zshrc` for Zsh) to apply the changes.

#### For Windows

- Open PowerShell as Administrator.
- Set the environment variables:

  ```powershell
  [System.Environment]::SetEnvironmentVariable('GOOGLE_GEMINI_API_KEY', 'Your Google Gemini API Key', 'User')
  [System.Environment]::SetEnvironmentVariable('GITHUB_API_TOKEN', 'Your GitHub API Token', 'User')
  [System.Environment]::SetEnvironmentVariable('GITHUB_API_VERSION', '2022-11-28', 'User')
  ```

- Now you can run the CLI tool from anywhere in your terminal:

  ```bash
  gh-echo <GITHUB_REPOSITORY_URL> [OPTIONS]
  ```

  Example:

  ```bash
  gh-echo https://github.com/user/repo --output results.md
  ```

## Running the Tool Locally

### Prerequisites

1. **Python3+**: Ensure `Python3` is installed on your system. You can download it from [python.org](https://www.python.org/downloads/).
2. **Git**: Ensure Git is installed. You can download it from [git-scm.com](https://git-scm.com/).
3. **Poetry**: Install Poetry by following the instructions at [poetry.eustace.io](https://python-poetry.org/docs/#installation).

### Setup Instructions

#### 1. Clone the Repository

First, clone the repository to your local machine:

```bash
git clone https://github.com/AryanK1511/github-echo
cd github-echo
```

#### 2. Set Up Environment Variables

For running the tool locally, create a `.env` file in the root of the repository and add the following content:

```text
GOOGLE_GEMINI_API_KEY='Your API Key'
GITHUB_API_TOKEN='Your API Token'
GITHUB_API_VERSION='2022-11-28'
```

- Replace `'Your API Key'` with your [Google Gemini API Key](https://aistudio.google.com/app/apikey).
- Replace `'Your API Token'` with your [GitHub Access Token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens).

#### 3. Install Required Dependencies

Install the necessary Python packages using Poetry:

```bash
poetry install
```

This will install all required dependencies and set up a virtual environment.

#### 4. Activate the Virtual Environment

Activate the Poetry virtual environment with:

```bash
poetry shell
```

#### 5. Running the CLI Tool Locally

Once the environment is set up and dependencies are installed, you can run the tool locally.

##### On Windows

1. Open Command Prompt or PowerShell.

2. Navigate to the project directory:

   ```cmd
   cd path\to\github-echo
   ```

3. Run the script:

   ```cmd
   python _main.py <GITHUB_REPOSITORY_URL> [OPTIONS]
   ```

   Example:

   ```cmd
   python _main.py https://github.com/user/repo --output results.md
   ```

##### On macOS and Linux

1. Open Terminal.

2. Navigate to the project directory:

   ```bash
   cd /path/to/github-echo
   ```

3. Make the script executable (if needed):

   ```bash
   chmod +x _main.py
   ```

4. Run the script:

   ```bash
   python _main.py <GITHUB_REPOSITORY_URL> [OPTIONS]
   ```

   Example:

   ```bash
   python _main.py https://github.com/user/repo --output results.md
   ```

## Additional Information

- **For Help**: Run `./_main.py --help` or `python _main.py --help` to see the available options and usage instructions.
- **For Version**: Use the `--version` or `-v` flag to get the version number.

## Running Using Docker

> **WARNING:** If you run using Docker, it will deprive you of a lot of features that the command line tool offers. Pretty print becomes unavailable and overall it doesn't look very pretty. It's always recommended to run this tool locally for development purposes.

### Cloning the repo and setting the environment variables

- First, clone the repository to your local machine:

  ```bash
  git clone https://github.com/AryanK1511/github-echo
  cd github-echo
  ```

- Next, navigate to the `Dockerfile` in the root of this repository and fill in the environment variables

```txt
ENV GOOGLE_GEMINI_API_KEY='Your API Key'
ENV GITHUB_API_TOKEN='Your API Key'
ENV GITHUB_API_VERSION='2022-11-28'
```

- Replace `'Your API Key'` with your [Google Gemini API Key](https://aistudio.google.com/app/apikey).
- Replace `'Your API Token'` with your [GitHub Access Token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens).
- You can leave the `GITHUB_API_VERSION` as is unless you really want to change it.

#### On Windows

- **Install Docker:** Download and install Docker Desktop from [Docker’s website](https://docs.docker.com/engine/install/).
- **Build the Docker Image:** Open Command Prompt or PowerShell, navigate to the project directory, and build the Docker image:

  ```cmd
  docker build -t gh-echo .
  ```

- **Run the Docker Container:** Once the image is built, you can run a container with the following command:

  ```cmd
  docker run --rm gh-echo <GITHUB_REPOSITORY_URL> [OPTIONS]
  ```

  Example:

  ```cmd
  docker run --rm gh-echo https://github.com/user/repo --output results.md
  ```

#### On macOS and Linux

- **Install Docker:** Follow instructions at [Docker’s website](https://docs.docker.com/engine/install/).
- **Build the Docker Image:** Open Terminal, navigate to the project directory, and build the Docker image:

  ```bash
  docker build -t gh-echo .
  ```

- **Run the Docker Container:** Once the image is built, you can run a container with the following command:

  ```bash
  docker run --rm gh-echo <GITHUB_REPOSITORY_URL> [OPTIONS]
  ```

  Example:

  ```bash
  docker run --rm gh-echo https://github.com/user/repo --output results.md
  ```

## Troubleshooting

- **Invalid GitHub URL**: Ensure the URL is correct and follows the format `https://github.com/owner/repo`.
- **Connection Issues**: Check your internet connection and API tokens.
- **Permission Errors**: On Windows, ensure you have the necessary permissions to run scripts. On macOS/Linux, ensure the script has execution permissions.

## Further Usage Instructions

```bash
_main.py [OPTIONS] GITHUB_REPOSITORY_URL COMMAND [ARGS]..._
```

### Arguments

| Argument                | Tsype | Description                                 | Default | Required |
| ----------------------- | ----- | ------------------------------------------- | ------- | -------- |
| `github_repository_url` | TEXT  | The URL of the GitHub repository to analyze | None    | Yes      |

### Options

| Option          | Shortcut | Type   | Description                                           | Default |
| --------------- | -------- | ------ | ----------------------------------------------------- | ------- |
| `--version`     | `-v`     | Flag   | Get the version number                                | `N/A`   |
| `--temperature` | `-t`     | Option | Set the temperature for the model's output randomness | `0.5`   |
| `--output`      | `-o`     | PATH   | Path to the output file                               | None    |
| `--help`        |          | Flag   | Show this message and exit                            | `N/A`   |
| `--token-usage` |          | Flag   | Displays token usage to the user via `stderr`         | `N/A`   |

## More about `github-echo`

### Information drawn from the GitHub API

The tool fetches the following key information about GitHub repositories:

- **Repository Metadata**: Name, description, owner, URL, and other basic information.
- **Contributors**: Details about contributors, including their usernames, IDs, and avatars.
- **Issues and Pull Requests**: Information about open and closed issues and pull requests, including titles, states, and comments.
- **Labels**: Labels associated with issues and pull requests.
- **Activity Data**: Data related to repository activity, such as commit history and contributions.

### Gemini GenAI Integration

**Repo Insights** uses Gemini GenAI to analyze the fetched repository data. Gemini GenAI provides advanced capabilities for:

- **Summary Generation**: Creating comprehensive summaries based on the repository data.
- **Insight Extraction**: Identifying key patterns and insights that are not immediately obvious from raw data.

**How It Works**:

1. **Data Fetching**: The tool queries GitHub's API to gather repository data.
2. **Data Processing**: The fetched data is processed and formatted.
3. **AI Analysis**: The processed data is sent to Gemini GenAI, which analyzes it and generates a detailed summary.
4. **Summary Output**: The summary is either displayed in the terminal or saved to a specified file.

## Contributing

We welcome contributions to improve **Repo Insights**. If you have suggestions, bug reports, or enhancements, please open an issue or submit a pull request.

1. Fork the repository.
2. Create a feature branch (`git checkout -b feature/your-feature`).
3. Commit your changes (`git commit -am 'Add new feature'`).
4. Push to the branch (`git push origin feature/your-feature`).
5. Create a new Pull Request.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Author

[Aryan Khurana](https://www.github.com/AryanK1511)

            

Raw data

            {
    "_id": null,
    "home_page": "https://pypi.org/project/gh-echo/o",
    "name": "gh-echo",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<4.0,>=3.9",
    "maintainer_email": null,
    "keywords": "GitHub, GenAI, Python3, CLI",
    "author": "Aryan Khurana",
    "author_email": "aryankhurana1511@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/7f/59/c30f478f8efa385f84128a503727374283388f10fcd4e21333e1a9997201/gh_echo-0.2.0.tar.gz",
    "platform": null,
    "description": "<p align=\"center\">\n  <img width=\"100%\" src=\"https://github.com/AryanK1511/github-echo/blob/main/assets/logo.png?raw=true\"><br /><br />\n  <strong>A command-line tool built to obtain in-depth, actionable information about GitHub repositories that is often challenging to decipher manually</strong><br /><br />\n</p>\n\n<p align=\"center\">\n  <a href=\"https://python.org\">\n    <img src=\"https://img.shields.io/badge/Python-3.11-blue?logo=python&logoColor=white\" alt=\"Python Version\">\n  </a>\n  <a href=\"https://pypi.org/project/gh-echo/\">\n    <img src=\"https://img.shields.io/pypi/v/gh-echo?color=blue&label=pypi%20package\" alt=\"PyPI Version\">\n  </a>\n  <a href=\"https://github.com/AryanK1511/github-echo\">\n    <img src=\"https://img.shields.io/github/stars/AryanK1511/github-echo?style=social\" alt=\"GitHub Stars\">\n  </a>\n  <a href=\"https://github.com/AryanK1511/github-echo/graphs/contributors\">\n    <img src=\"https://img.shields.io/github/contributors/AryanK1511/github-echo\" alt=\"GitHub Contributors\">\n  </a>\n  <a href=\"https://opensource.org/licenses/MIT\">\n    <img src=\"https://img.shields.io/github/license/AryanK1511/github-echo\" alt=\"License\">\n  </a>\n  <a href=\"https://github.com/AryanK1511/github-echo/issues\">\n    <img src=\"https://img.shields.io/github/issues/AryanK1511/github-echo\" alt=\"GitHub Issues\">\n  </a>\n  <a href=\"https://youtu.be/bTbETpn7C9I\">\n    <img src=\"https://img.shields.io/badge/Watch-Demo-red?logo=youtube\" alt=\"Watch Demo\">\n  </a>\n</p>\n\n## Table of Contents\n\n- [Usage](#usage)\n- [Installing via PyPi](#installing-via-pypi)\n  - [Prerequisites](#prerequisites)\n  - [Setup Instructions](#setup-instructions)\n    - [For macOS/Linux](#for-macoslinux)\n    - [For Windows](#for-windows)\n- [Running the Tool Locally](#running-the-tool-locally)\n  - [Prerequisites](#prerequisites-1)\n  - [Setup Instructions](#setup-instructions-1)\n    - [1. Clone the Repository](#1-clone-the-repository)\n    - [2. Set Up Environment Variables](#2-set-up-environment-variables)\n    - [3. Install Required Dependencies](#3-install-required-dependencies)\n    - [4. Activate the Virtual Environment](#4-activate-the-virtual-environment)\n    - [5. Running the CLI Tool Locally](#5-running-the-cli-tool-locally)\n      - [On Windows](#on-windows)\n      - [On macOS and Linux](#on-macos-and-linux)\n- [Running Using Docker](#running-using-docker)\n  - [On Windows](#on-windows-1)\n  - [On macOS and Linux](#on-macos-and-linux-1)\n- [Troubleshooting](#troubleshooting)\n- [Further Usage Instructions](#further-usage-instructions)\n  - [Arguments](#arguments)\n  - [Options](#options)\n- [More about `github-echo`](#more-about-github-echo)\n  - [Information drawn from the GitHub API](#information-drawn-from-the-github-api)\n  - [Gemini GenAI Integration](#gemini-genai-integration)\n- [Contributing](#contributing)\n- [License](#license)\n- [Author](#author)\n\n## Usage\n\nYou can use this tool in two ways:\n\n1. **[Install via PyPi](#installing-via-pypi)**: Quickly set up the tool with a simple `pip install`.\n2. **[Run Locally](#running-the-tool-locally)**: Clone the repository and run it directly on your machine for development or testing.\n\n## Installing via `PyPi`\n\n### Prerequisites\n\n1. **Python3+**: Ensure `Python3` is installed on your system. You can download it from [python.org](https://www.python.org/downloads/).\n\n### Setup Instructions\n\n1. Open a terminal or command prompt.\n\n2. Install the tool via PyPi:\n\n   ```bash\n   pip install gh-echo\n   ```\n\n3. Once installed, you need to set the required environment variables in your shell configuration. Here are the steps for different systems:\n\n#### For macOS/Linux\n\n- Open your terminal.\n- Add the environment variables to your shell configuration file (e.g., `.bashrc`, `.zshrc`, etc.)\n\n  ```bash\n  export GOOGLE_GEMINI_API_KEY='Your Google Gemini API Key'\n  export GITHUB_API_TOKEN='Your GitHub API Token'\n  export GITHUB_API_VERSION='2022-11-28'\n  ```\n\n- Run `source ~/.bashrc` (or `source ~/.zshrc` for Zsh) to apply the changes.\n\n#### For Windows\n\n- Open PowerShell as Administrator.\n- Set the environment variables:\n\n  ```powershell\n  [System.Environment]::SetEnvironmentVariable('GOOGLE_GEMINI_API_KEY', 'Your Google Gemini API Key', 'User')\n  [System.Environment]::SetEnvironmentVariable('GITHUB_API_TOKEN', 'Your GitHub API Token', 'User')\n  [System.Environment]::SetEnvironmentVariable('GITHUB_API_VERSION', '2022-11-28', 'User')\n  ```\n\n- Now you can run the CLI tool from anywhere in your terminal:\n\n  ```bash\n  gh-echo <GITHUB_REPOSITORY_URL> [OPTIONS]\n  ```\n\n  Example:\n\n  ```bash\n  gh-echo https://github.com/user/repo --output results.md\n  ```\n\n## Running the Tool Locally\n\n### Prerequisites\n\n1. **Python3+**: Ensure `Python3` is installed on your system. You can download it from [python.org](https://www.python.org/downloads/).\n2. **Git**: Ensure Git is installed. You can download it from [git-scm.com](https://git-scm.com/).\n3. **Poetry**: Install Poetry by following the instructions at [poetry.eustace.io](https://python-poetry.org/docs/#installation).\n\n### Setup Instructions\n\n#### 1. Clone the Repository\n\nFirst, clone the repository to your local machine:\n\n```bash\ngit clone https://github.com/AryanK1511/github-echo\ncd github-echo\n```\n\n#### 2. Set Up Environment Variables\n\nFor running the tool locally, create a `.env` file in the root of the repository and add the following content:\n\n```text\nGOOGLE_GEMINI_API_KEY='Your API Key'\nGITHUB_API_TOKEN='Your API Token'\nGITHUB_API_VERSION='2022-11-28'\n```\n\n- Replace `'Your API Key'` with your [Google Gemini API Key](https://aistudio.google.com/app/apikey).\n- Replace `'Your API Token'` with your [GitHub Access Token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens).\n\n#### 3. Install Required Dependencies\n\nInstall the necessary Python packages using Poetry:\n\n```bash\npoetry install\n```\n\nThis will install all required dependencies and set up a virtual environment.\n\n#### 4. Activate the Virtual Environment\n\nActivate the Poetry virtual environment with:\n\n```bash\npoetry shell\n```\n\n#### 5. Running the CLI Tool Locally\n\nOnce the environment is set up and dependencies are installed, you can run the tool locally.\n\n##### On Windows\n\n1. Open Command Prompt or PowerShell.\n\n2. Navigate to the project directory:\n\n   ```cmd\n   cd path\\to\\github-echo\n   ```\n\n3. Run the script:\n\n   ```cmd\n   python _main.py <GITHUB_REPOSITORY_URL> [OPTIONS]\n   ```\n\n   Example:\n\n   ```cmd\n   python _main.py https://github.com/user/repo --output results.md\n   ```\n\n##### On macOS and Linux\n\n1. Open Terminal.\n\n2. Navigate to the project directory:\n\n   ```bash\n   cd /path/to/github-echo\n   ```\n\n3. Make the script executable (if needed):\n\n   ```bash\n   chmod +x _main.py\n   ```\n\n4. Run the script:\n\n   ```bash\n   python _main.py <GITHUB_REPOSITORY_URL> [OPTIONS]\n   ```\n\n   Example:\n\n   ```bash\n   python _main.py https://github.com/user/repo --output results.md\n   ```\n\n## Additional Information\n\n- **For Help**: Run `./_main.py --help` or `python _main.py --help` to see the available options and usage instructions.\n- **For Version**: Use the `--version` or `-v` flag to get the version number.\n\n## Running Using Docker\n\n> **WARNING:** If you run using Docker, it will deprive you of a lot of features that the command line tool offers. Pretty print becomes unavailable and overall it doesn't look very pretty. It's always recommended to run this tool locally for development purposes.\n\n### Cloning the repo and setting the environment variables\n\n- First, clone the repository to your local machine:\n\n  ```bash\n  git clone https://github.com/AryanK1511/github-echo\n  cd github-echo\n  ```\n\n- Next, navigate to the `Dockerfile` in the root of this repository and fill in the environment variables\n\n```txt\nENV GOOGLE_GEMINI_API_KEY='Your API Key'\nENV GITHUB_API_TOKEN='Your API Key'\nENV GITHUB_API_VERSION='2022-11-28'\n```\n\n- Replace `'Your API Key'` with your [Google Gemini API Key](https://aistudio.google.com/app/apikey).\n- Replace `'Your API Token'` with your [GitHub Access Token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens).\n- You can leave the `GITHUB_API_VERSION` as is unless you really want to change it.\n\n#### On Windows\n\n- **Install Docker:** Download and install Docker Desktop from [Docker\u2019s website](https://docs.docker.com/engine/install/).\n- **Build the Docker Image:** Open Command Prompt or PowerShell, navigate to the project directory, and build the Docker image:\n\n  ```cmd\n  docker build -t gh-echo .\n  ```\n\n- **Run the Docker Container:** Once the image is built, you can run a container with the following command:\n\n  ```cmd\n  docker run --rm gh-echo <GITHUB_REPOSITORY_URL> [OPTIONS]\n  ```\n\n  Example:\n\n  ```cmd\n  docker run --rm gh-echo https://github.com/user/repo --output results.md\n  ```\n\n#### On macOS and Linux\n\n- **Install Docker:** Follow instructions at [Docker\u2019s website](https://docs.docker.com/engine/install/).\n- **Build the Docker Image:** Open Terminal, navigate to the project directory, and build the Docker image:\n\n  ```bash\n  docker build -t gh-echo .\n  ```\n\n- **Run the Docker Container:** Once the image is built, you can run a container with the following command:\n\n  ```bash\n  docker run --rm gh-echo <GITHUB_REPOSITORY_URL> [OPTIONS]\n  ```\n\n  Example:\n\n  ```bash\n  docker run --rm gh-echo https://github.com/user/repo --output results.md\n  ```\n\n## Troubleshooting\n\n- **Invalid GitHub URL**: Ensure the URL is correct and follows the format `https://github.com/owner/repo`.\n- **Connection Issues**: Check your internet connection and API tokens.\n- **Permission Errors**: On Windows, ensure you have the necessary permissions to run scripts. On macOS/Linux, ensure the script has execution permissions.\n\n## Further Usage Instructions\n\n```bash\n_main.py [OPTIONS] GITHUB_REPOSITORY_URL COMMAND [ARGS]..._\n```\n\n### Arguments\n\n| Argument                | Tsype | Description                                 | Default | Required |\n| ----------------------- | ----- | ------------------------------------------- | ------- | -------- |\n| `github_repository_url` | TEXT  | The URL of the GitHub repository to analyze | None    | Yes      |\n\n### Options\n\n| Option          | Shortcut | Type   | Description                                           | Default |\n| --------------- | -------- | ------ | ----------------------------------------------------- | ------- |\n| `--version`     | `-v`     | Flag   | Get the version number                                | `N/A`   |\n| `--temperature` | `-t`     | Option | Set the temperature for the model's output randomness | `0.5`   |\n| `--output`      | `-o`     | PATH   | Path to the output file                               | None    |\n| `--help`        |          | Flag   | Show this message and exit                            | `N/A`   |\n| `--token-usage` |          | Flag   | Displays token usage to the user via `stderr`         | `N/A`   |\n\n## More about `github-echo`\n\n### Information drawn from the GitHub API\n\nThe tool fetches the following key information about GitHub repositories:\n\n- **Repository Metadata**: Name, description, owner, URL, and other basic information.\n- **Contributors**: Details about contributors, including their usernames, IDs, and avatars.\n- **Issues and Pull Requests**: Information about open and closed issues and pull requests, including titles, states, and comments.\n- **Labels**: Labels associated with issues and pull requests.\n- **Activity Data**: Data related to repository activity, such as commit history and contributions.\n\n### Gemini GenAI Integration\n\n**Repo Insights** uses Gemini GenAI to analyze the fetched repository data. Gemini GenAI provides advanced capabilities for:\n\n- **Summary Generation**: Creating comprehensive summaries based on the repository data.\n- **Insight Extraction**: Identifying key patterns and insights that are not immediately obvious from raw data.\n\n**How It Works**:\n\n1. **Data Fetching**: The tool queries GitHub's API to gather repository data.\n2. **Data Processing**: The fetched data is processed and formatted.\n3. **AI Analysis**: The processed data is sent to Gemini GenAI, which analyzes it and generates a detailed summary.\n4. **Summary Output**: The summary is either displayed in the terminal or saved to a specified file.\n\n## Contributing\n\nWe welcome contributions to improve **Repo Insights**. If you have suggestions, bug reports, or enhancements, please open an issue or submit a pull request.\n\n1. Fork the repository.\n2. Create a feature branch (`git checkout -b feature/your-feature`).\n3. Commit your changes (`git commit -am 'Add new feature'`).\n4. Push to the branch (`git push origin feature/your-feature`).\n5. Create a new Pull Request.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Author\n\n[Aryan Khurana](https://www.github.com/AryanK1511)\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A command-line tool built to obtain in-depth, actionable information about GitHub repositories.",
    "version": "0.2.0",
    "project_urls": {
        "Documentation": "https://github.com/AryanK1511/github-echo/blob/main/README.md",
        "Homepage": "https://pypi.org/project/gh-echo/o",
        "Repository": "https://github.com/AryanK1511/github-echo"
    },
    "split_keywords": [
        "github",
        " genai",
        " python3",
        " cli"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c25d6162e1bd04499f769d3120aa89345c9fa9f56518cd8b22280f19000342e7",
                "md5": "dd5fe86863a64545119c5d00aa6acb0f",
                "sha256": "734002222c945d6d87dac365a5be114c1925b5c6fbca778a65420987ca68ba34"
            },
            "downloads": -1,
            "filename": "gh_echo-0.2.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "dd5fe86863a64545119c5d00aa6acb0f",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4.0,>=3.9",
            "size": 16921,
            "upload_time": "2024-09-19T18:49:47",
            "upload_time_iso_8601": "2024-09-19T18:49:47.446753Z",
            "url": "https://files.pythonhosted.org/packages/c2/5d/6162e1bd04499f769d3120aa89345c9fa9f56518cd8b22280f19000342e7/gh_echo-0.2.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "7f59c30f478f8efa385f84128a503727374283388f10fcd4e21333e1a9997201",
                "md5": "418ced50193d95e7d833f3ef8e9b1657",
                "sha256": "bf4530c8df3ec9723cd6afb91f6461940d72f909ff3f3d6b547caa81778120f3"
            },
            "downloads": -1,
            "filename": "gh_echo-0.2.0.tar.gz",
            "has_sig": false,
            "md5_digest": "418ced50193d95e7d833f3ef8e9b1657",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4.0,>=3.9",
            "size": 16653,
            "upload_time": "2024-09-19T18:49:48",
            "upload_time_iso_8601": "2024-09-19T18:49:48.927833Z",
            "url": "https://files.pythonhosted.org/packages/7f/59/c30f478f8efa385f84128a503727374283388f10fcd4e21333e1a9997201/gh_echo-0.2.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-09-19 18:49:48",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "AryanK1511",
    "github_project": "github-echo",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "gh-echo"
}
        
Elapsed time: 6.56460s