diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4247f4f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,40 @@
+# Marhal Controller for TD2 (Train Driver 2) Simulator
+
+Welcome to the Marhal Controller repository for TD2 (Train Driver 2) Simulator! This repository contains the source code for the Marhal Controller project, a system designed to manage and control humping signals within the TD2 simulator.
+
+## Overview
+
+Marhal Controller serves as the central management hub for coordinating humping signal operations.
+
+## Features
+
+- **Humping Signal Control**: Manage and control humping signals to ensure safe and efficient train operations.
+- **Integration with TD2 Simulator**: Seamlessly integrate with the Train Driver 2 simulator environment for realistic train operation scenarios.
+
+## Getting Started
+
+To get started with Marhal Controller for TD2 Simulator, follow these steps:
+
+1. **Installation**: Clone this repository to your local environment or download the latest release from the [releases](https://github.com/username/marhal-controller/releases) section.
+
+2. **Configuration**: Modify the configuration files to specify signal patterns, track layouts, and other parameters relevant to your TD2 simulator environment.
+
+## Documentation
+
+For detailed instructions on installation, configuration, usage, and troubleshooting, please refer to the [documentation](docs/README.md).
+
+## Contributing
+
+We welcome contributions from the community to enhance Marhal Controller for TD2 Simulator. If you would like to contribute, please follow our [contribution guidelines](CONTRIBUTING.md).
+
+## Support
+
+If you encounter any issues or need assistance, feel free to [open an issue](https://github.com/username/marhal-controller/issues). Our team will be happy to assist you.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+We would like to express our gratitude to the TD2 simulator community and all contributors who have supported Marhal Controller for TD2 Simulator.