base on An OSINT / digital forensics tool built in Python # Project | Horus <p align="center"> <img src="https://i.ibb.co/LSYgyHh/Screenshot-2024-06-30-at-12-51-09-AM.png"/> </p> <div align="center"> [](https://github.com/6abd/horus "Go to GitHub repo") [](https://github.com/6abd/horus/releases/) [](https://github.com/6abd/horus) [](https://github.com/6abd/horus) [](https://github.com/6abd/horus/issues) [](#license) </div> # Table of Contents * [🚀 About Horus](#-about-horus) * [⚡ Installation and Usage Instructions](#-installation-and-usage-instructions) * [⚙️ API Configuration](#%EF%B8%8F-api-configuration) * [🔮 Intended Features](#-intended-features) * [🤝 Current Maintainers](#-current-maintainers) * [🛠️ Contributing](#%EF%B8%8F-contributing) * [📧 Contact Me](#-contact-me) * [🤝 Acknowledgements](#-acknowledgements) ## 🚀 About Horus Horus is an all-in-one encompassing tool for investigations assistance, from API leveraging to compiling data too. Its your pre-ops buddy! ## ⚡ Installation and Usage Instructions To get started with this project, you will need Python installed on your device. Once it is installed, follow these steps: 1. Clone this repository. 2. `cd` to the 'horus' directory. (Make sure it isn't the outermost folder) 3. Install dependencies using the following command: ```pip install -r requirements.txt``` 4. In the 'horus' directory, run ```python3 horus.py``` on Linux/MacOS, or ```py horus.py``` on Windows *Note: protonvpn-cli is a requirement for the 'pvpn' command* *Note: openvpn CLI is a requirement for the 'ovpn' command* ## ⚙️ API Configuration To configure the APIs necessary for usage of certain commands, you can either manually enter them, or use the 'apicon' command To manually configure API keys, navigate to ```/src/modules/var/pipes/api_config.json```. Enter your API keys in their corresponding entries. **⚠️ Warning: If you are contributing to this repository or are testing it through a public fork, make sure to remove your API keys from the JSON file before pushing changes.** ## 🔮 Intended Features ``` 🟢 = Fully implemented or more than 80% done 🟡 = Partially implemented / In development 🔴 = To be implemented ``` <p align="center"> <img src="https://i.ibb.co/1Gknr1b/Screenshot-2024-07-11-at-10-20-11-AM.png"/> </p> *On Shodan: Shodan is a paid API, so in order for your API to work you need to subscribe to them. A lot of its feature's location-related functionality is available in 'geolock', but more detailed features require that API.* ## 🤝 Current Maintainers - [6abd](https://github.com/6abd) (Me) | Project Lead and Developer ## 🛠️ Contributing - If you notice a bug or want to request a feature, make an issue with the appropriate tag - If you would like to fix a bug or add a feature yourself, make a PR and I'll take a look - If you would like to become a long-term maintainer/contributor, contact me - For any other inquiries, you may also contact me ## 📧 Contact Me - Email: [email protected] - Discord: maestro.hq or through the [community server](https://discord.gg/PhkqXAT7Ax) ## 🤝 Acknowledgements - [Fox](https://github.com/FoxIDK) | Was Previously Project Manager - [Tornado](https://github.com/digitalsilicon) | Was Previously QA - [Mart](https://github.com/marvhus) | Was Previously Sr Dev - [Mu](https://github.com/IamMU) | Was Previously Jr Dev *Some code used can be attributed to [Fox](https://github.com/FoxIDK) and [Askerdyne Ltd.](https://askerdyne.com/), specifically the 'Loki' encryption toolset.* *Some `.github` files were made by [Jesse Squires](https://github.com/jessesquires)* <a href="https://www.producthunt.com/posts/horus?utm_source=badge-featured&utm_medium=badge&utm_souce=badge-horus" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=453469&theme=light" alt="Horus - An&#0032;OSINT&#0032;&#0047;&#0032;digital&#0032;forensics&#0032;tool&#0032;built&#0032;in&#0032;Python | Product Hunt" style="width: 250px; height: 54px;" width="250" height="54" /></a> ", Assign "at most 3 tags" to the expected json: {"id":"9349","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"