Project | Horus

Table of Contents

• 🚀 About Horus
• ⚡ Installation and Usage Instructions
• ⚙️ API Configuration
• 🔮 Intended Features
• 🤝 Current Maintainers
• 🛠️ Contributing
• 📧 Contact Me
• 🤝 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

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 (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

🤝 Acknowledgements

• Fox | Was Previously Project Manager
• Tornado | Was Previously QA
• Mart | Was Previously Sr Dev
• Mu | Was Previously Jr Dev

Some code used can be attributed to Fox and Askerdyne Ltd., specifically the 'Loki' encryption toolset.

Some .github files were made by Jesse Squires