{"id":22429878,"url":"https://github.com/Life-Experimentalist/BreachCheck","last_synced_at":"2025-10-16T00:31:22.416Z","repository":{"id":264479125,"uuid":"893461325","full_name":"VKrishna04/BreachCheck","owner":"VKrishna04","description":"BreachCheck is a tool designed to help users check if their email addresses or passwords have been involved in known data breaches. It leverages APIs from various breach databases aggregators to provide users with information about their potential exposure.","archived":false,"fork":false,"pushed_at":"2024-12-04T19:46:13.000Z","size":62,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-01T12:11:39.495Z","etag":null,"topics":["breach-check","email-phishing","password-safety","pure-python","streamlit","unsplash-api"],"latest_commit_sha":null,"homepage":"https://breachcheck-sagittarius.streamlit.app/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VKrishna04.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"License","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-24T14:08:24.000Z","updated_at":"2024-12-04T19:46:16.000Z","dependencies_parsed_at":"2024-11-24T16:45:56.250Z","dependency_job_id":null,"html_url":"https://github.com/VKrishna04/BreachCheck","commit_stats":null,"previous_names":["vkrishna04/breachcheck"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VKrishna04%2FBreachCheck","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VKrishna04%2FBreachCheck/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VKrishna04%2FBreachCheck/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VKrishna04%2FBreachCheck/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VKrishna04","download_url":"https://codeload.github.com/VKrishna04/BreachCheck/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":236658019,"owners_count":19184581,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["breach-check","email-phishing","password-safety","pure-python","streamlit","unsplash-api"],"created_at":"2024-12-05T21:06:01.084Z","updated_at":"2025-10-16T00:31:22.073Z","avatar_url":"https://github.com/VKrishna04.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BreachCheck - Sagittarius\n\u003cimg src=\"https://socialify.git.ci/VKrishna04/BreachCheck/image?description=1\u0026forks=1\u0026issues=1\u0026language=1\u0026name=1\u0026owner=1\u0026pattern=Circuit%20Board\u0026pulls=1\u0026stargazers=1\u0026theme=Auto\" alt=\"BreachCheck\" width=\"640\" height=\"320\" style=\"align-items: center\" /\u003e\n## Introduction\n\nWe strongly advise users to only utilize BreachCheck for their own emails and passwords. Do not misuse this tool or exploit it for malicious purposes. Respect the privacy and security of others by refraining from attempting to check passwords that do not belong to you.\n\nOur aim is to promote responsible and ethical use of BreachCheck to empower individuals in securing their online presence. By adhering to these principles, we can collectively contribute to a safer digital environment for everyone.\n\nYou can experience the application [https://breachcheck-sagittarius.streamlit.app/](https://breachcheck-sagittarius.streamlit.app/) which is hosted on Streamlit Sharing Cloud.\n\n## Project Structure\n\n```yaml\nBreachCheck/\n│\n├── Interfaces/\n│   └── streamlit_app.py  # Main Streamlit application interface\n│\n├── api/\n│   └── breach_api.py  # API integration for breach checks\n│\n├── scripts/\n│   ├── run_app  # Extensionless script to detect OS and run the appropriate script\n│   ├── run_app.sh  # Shell script for Unix-based systems\n│   ├── run_app.bat  # Batch script for Windows\n│   └── run_app.ps1  # PowerShell script for Windows\n│\n├── docs/\n│   ├── faq_and_contributions.py  # Frequently Asked Questions and Contributions\n│   └── terms.md  # Terms and Conditions\n│\n├── README.md  # Project documentation\n├── conf.json  # Configuration file for API keys and settings\n├── requirements.txt  # Python dependencies\n├── app.py  # Entry point to run the Streamlit application\n└── app_complete.py  # Entry point to run the Complete Streamlit application in a single file.\n```\n\nNote: This `app_complete.py` file is not used in the project and is a little behind the main `app.py` file. For Contributions, please refer to the `app.py` file.\n\n\n## Usage\n\n### Prerequisites\n\nEnsure you have Python 3.6 or later installed on your system.\n\n### Installation\n\n1. **Clone the repository:**\n    ```bash\n    git clone https://github.com/VKrishna04/BreachCheck.git\n    cd BreachCheck\n    ```\n\n2. **Create a virtual environment (not required):**\n    On Linux\n    ```bash\n    python -m venv venv\n    source venv/bin/activate\n    ```\n\n    On Windows\n    ```ps1\n    python -m venv venv\n    source venv\\Scripts\\activate\n    ```\n\n    On MacOS\n    ```bash\n    python3 -m venv venv\n    source venv/bin/activate\n    ```\n\nThis will provide clear instructions for setting up and activating a virtual environment on both Windows and macOS.\n\n3. **Install the required packages:**\n    ```bash\n    pip install -r requirements.txt\n    ```\n\nThis is for installing the necessary packages to run the Streamlit application and tabulate package required in cli interface.\n\n### Running the Application\n\nTo run the Streamlit application there are three ways:\n1. You can visit this site [https://breachcheck-sagittarius.streamlit.app/](https://breachcheck-sagittarius.streamlit.app/) to use the Streamlit app which is hosted on Streamlit Sharing Cloud.\n\n2. Using the batch file, use the following command:\n    ```bash\n    .\\run_app.bat\n    ```\n3. Using the shortcut file named \"Sagittarius\" in the root directory of the project. It is the name of the team which made this project.\n\nNote: If you are using the batch file, make sure to run it from the root directory of the project.\n\n3. Don't run the Streamlit app python file manually, it will not work as expected since it is set to open CLI.\n\n4. To modify the user theme of the Streamlit app, you can change the necessary variables [here](.streamlit/config.toml). The theme is set to \"dark\" by default.\n\n### Running the CLI Interface\n\nTo run the CLI interface manually, use the following command:\n```bash\npython app.py --cli\n```\n\n### Complete App in single file\n\nBelow is the complete code for the application which is running directly without any support files:\n\nTo run this code as a normal Python file to use CLI, use the following command:\n\n```bash\npython app_complete.py --cli\n```\n\nTo run this code as a Streamlit app, use the following command:\n```bash\nstreamlit run app_complete.py\n```\n\n## Contributors\n\n### Team Leader\n1. [@VKrishna04](https://github.com/VKrishna04)\n\n### Frontend\n1. [@harsha4678](https://github.com/harsha4678) \u003c- Figma Landing Page\n2. [@longhxirguy](https://github.com/longhxirguy) \u003c- Streamlit Frontend\n\n### APIs Integration\n1. [@Karthikkkk123](https://github.com/Karthikkkk123) \u003c- Streamlit Interface\n2. [@Saisriram-88](https://github.com/Saisriram-88) \u003c- CLI\n\n### Support / Error Testing\n1. [@Jayanth-0703](https://github.com/Jayanth-0703)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLife-Experimentalist%2FBreachCheck","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FLife-Experimentalist%2FBreachCheck","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLife-Experimentalist%2FBreachCheck/lists"}