diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d03d63d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,39 @@
+# CodeQuery 🛡️🔍
+
+Welcome to the CodeQuery repository, a powerful and efficient web application security reconnaissance tool. This tool is designed to help security professionals and enthusiasts in performing thorough and effective penetration testing.
+
+## 🚀 Features
+
+CodeQuery comes with a robust set of features designed to help you uncover potential security vulnerabilities in web applications:
+
+- **High-Speed Crawling**: Efficiently scans large websites, generating comprehensive security reports.
+- **Heuristic Detection**: Uses advanced heuristics to identify vulnerabilities and potential security issues.
+- **Customizable Settings**: Allows users to fine-tune scanning parameters for tailored security assessments.
+- **Detailed Reports**: Generates easy-to-read reports highlighting identified vulnerabilities, complete with remediation recommendations.
+- **Multi-Platform Support**: Compatible with various operating systems, ensuring versatile deployment options.
+
+## 🛠️ Installation Instructions
+
+To get started with CodeQuery, follow these simple installation steps:
+
+1. Navigate to our [Releases](../../releases) page.
+2. Download the latest version of CodeQuery.
+3. Unpack the downloaded archive.
+4. Run the application from the unpacked directory.
+
+## 🕹️ How to Use
+
+After installation, you can start using CodeQuery to scan web applications for vulnerabilities. Here’s a basic usage guide:
+
+1. Open a terminal and navigate to the CodeQuery directory.
+2. Run the following command to start a scan:
+3. Access the generated reports in the specified output directory to review the findings and take necessary actions.
+
+🛑 Contributions
+We are currently not seeking contributions. However, you are welcome to fork the repository, explore its functionality, and adapt it for personal use.
+
+🐞 Reporting Issues
+If you encounter any problems or have suggestions for improvement, please visit our Issues page to let us know.
+
+🌟 Thank You for Using CodeQuery!
+Secure your web applications and enhance your penetration testing efforts with CodeQuery, your trusted tool for web security reconnaissance.