{"id":34501531,"url":"https://github.com/solanav/phishflood","last_synced_at":"2026-03-11T23:35:30.506Z","repository":{"id":211947803,"uuid":"730309136","full_name":"solanav/phishflood","owner":"solanav","description":"Flood phishing websites with realistic fake credentials","archived":false,"fork":false,"pushed_at":"2024-01-15T16:02:38.000Z","size":113880,"stargazers_count":16,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-25T13:19:25.769Z","etag":null,"topics":["credentials","fake-data-generator","phishing","playwright-python"],"latest_commit_sha":null,"homepage":"https://solana.miami/phishflood/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/solanav.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-12-11T16:38:36.000Z","updated_at":"2024-09-17T19:20:08.000Z","dependencies_parsed_at":"2024-01-03T10:53:27.669Z","dependency_job_id":"6adcd734-981a-45ea-bcc6-d91c46a8ccf6","html_url":"https://github.com/solanav/phishflood","commit_stats":null,"previous_names":["solanav/phishflood"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/solanav/phishflood","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solanav%2Fphishflood","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solanav%2Fphishflood/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solanav%2Fphishflood/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solanav%2Fphishflood/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/solanav","download_url":"https://codeload.github.com/solanav/phishflood/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solanav%2Fphishflood/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30407116,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-11T22:36:59.286Z","status":"ssl_error","status_checked_at":"2026-03-11T22:36:57.544Z","response_time":84,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["credentials","fake-data-generator","phishing","playwright-python"],"created_at":"2025-12-24T02:02:28.911Z","updated_at":"2026-03-11T23:35:30.476Z","avatar_url":"https://github.com/solanav.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PhishFlood\n\nPhishFlood is a python tool that uses playwright to automate the process of filling phishing websites with fake credentials.\n\n\u003e **_NOTE_** This tool is meant for educational and research purposes only. Unauthorized use of this tool is strictly prohibited. The developers are not responsible for any misuse or damage caused by this tool.\n\n## Table of content\n- [PhishFlood](#phishflood)\n  - [Table of content](#table-of-content)\n  - [Demo](#demo)\n  - [Installation](#installation)\n    - [Prerequisites](#prerequisites)\n    - [Clone the Repository](#clone-the-repository)\n    - [Install Dependencies with Poetry](#install-dependencies-with-poetry)\n  - [Usage](#usage)\n    - [Running CLI](#running-cli)\n    - [Running the API](#running-the-api)\n  - [Testing](#testing)\n  - [Contributing](#contributing)\n    - [Architecture](#architecture)\n  - [License](#license)\n\n## Demo\n\nExample page interaction:\n![](images//output.gif)\n\nExample output:\n```json\n{\n    \"url\": \"https://online.ib-internet-bakingssg.com/\",\n    \"html\": \"...\",\n    \"forms\": [\n        {\n            \"meta_id\": 0,\n            \"id\": null,\n            \"action\": null,\n            \"method\": \"none\",\n            \"type\": null,\n            \"inputs\": [\n                {\n                    \"meta_id\": 0,\n                    \"id\": null,\n                    \"name\": \"UID\",\n                    \"placeholder\": null,\n                    \"type\": \"text\"\n                },\n                {\n                    \"meta_id\": 1,\n                    \"id\": null,\n                    \"name\": \"pin\",\n                    \"placeholder\": null,\n                    \"type\": \"number\"\n                }\n            ]\n        }\n    ],\n    \"actions\": [\n        {\n            \"action\": \"fill\",\n            \"form\": 0,\n            \"input\": 0,\n            \"value\": \"cyber_dragon83\",\n            \"status\": \"success\"\n        },\n        {\n            \"action\": \"fill\",\n            \"form\": 0,\n            \"input\": 1,\n            \"value\": \"383510\",\n            \"status\": \"success\"\n        }\n    ]\n}\n```\n\n\n## Installation\n\n### Prerequisites\n\n- Python 3.11 or higher\n- Git\n- Poetry\n\n### Clone the Repository\n\n```bash\ngit clone https://github.com/solanav/phishflood.git\ncd phishflood\n```\n\n### Install Dependencies with Poetry\n\n```bash\npoetry install\n```\n\n## Usage\n\n### Running CLI\n\n```bash\npoetry run python -m phishflood example.org\n```\n\nPhishFlood will launch a Playwright browser instance in the background and start filling in fake credentials on known phishing websites. The results will be stored on the `samples/` directory.\n\n### Running the API\n\nTo start the API and all required componets (RabbitMQ, PostgreSQL and the workers) you can run:\n\n```bash\ndocker compose -f docker/docker-compose.yml --compatibility up --build\n```\n\nThe API will be running in `localhost:8000` and you can start exploring the different endpoints through the web UI:\n\n![Alt text](images/api_root.png)\n\nAnd here is a sample of one of the endpoints\n\n![Alt text](images//action_list.png)\n\n\n## Testing\n\nWe use [pytest](https://docs.pytest.org/en/stable/) for testing. To run the tests, use the following command:\n\n```bash\npoetry run pytest\n```\n\nMake sure to have a controlled testing environment, as the tests involve interactions with websites.\n\n## Contributing\n\nIf you would like to contribute to this project, please open an issue or submit a pull request. We welcome any suggestions, improvements, or bug fixes.\n\n### Architecture\n\nHere is a general overview of the code in this repository so you have an easier time contributing:\n- `api/`: django project that provides the API to submit new cases and retrieve results.\n- `credfind/`: module that finds forms and inputs in a given HTML source file.\n- `credgen/`: module that generates random (realistic) credentials for inputs found in `credfind`.\n- `data/`: folder with emails and passwords for the `credgen` module.\n- `docker/`: contains the docker-compose and Dockerfiles necesary to get up and running the service.\n- `pages/`: HTML sites to test the modules.\n- `phishflood/`: main module that glues credfind and credgen, using [playwright](https://github.com/microsoft/playwright-python).\n- `samples/`: output for the information obtained when using the `phishflood` manually as opposed to using it through the API.\n- `tests/`: folder containing the unittests that check everything is behaving as expected.\n- `entrypoint.sh`: script that prepares the django `api` and launches it. Used in `docker/Dockerfile.api`.\n\n## License\n\nThis project is licensed under the [AGPL License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolanav%2Fphishflood","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsolanav%2Fphishflood","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolanav%2Fphishflood/lists"}