diff --git a/README.md b/README.md
new file mode 100644
index 0000000..616afe0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,40 @@
+Tagger: Tag Replacement Tool
+Tagger is a versatile Java application designed to simplify the process of replacing tags within text content. It provides a user-friendly GUI that allows users to interactively replace tags in a structured manner. The application supports a wide range of features including tag extraction, tag comment retrieval, and advanced tag replacement options.
+
+Features
+Interactive GUI: Tagger offers an intuitive graphical user interface that allows users to seamlessly navigate and perform tag replacement operations.
+
+Tag Extraction: The application intelligently extracts tags from the provided content, making it easy for users to identify and manage tags.
+
+Tag Comment Retrieval: Tagger fetches tag comments associated with each tag, providing context to the user during the replacement process.
+
+Advanced Tag Replacement: Users can replace tags with customized text, including the ability to handle nested tags and optional tag content.
+
+Configuration Support: Tagger reads configuration settings from a JSON file, allowing users to easily customize database connections, table names, and more.
+
+Save and Load Data: Users can save and load data, enabling seamless work sessions across different instances of the application.
+
+Data Persistence: The application stores tag replacement history, allowing users to review and track previous tag replacements.
+
+Error Handling: Tagger provides informative error messages and visual alerts, including an error message for failed database connections.
+
+Version Control: The project maintains a comprehensive version history, making it easy to track changes and updates.
+
+Usage
+Launch the application.
+Select the mo_name from the dropdown.
+Click the "Process" button to begin the tag replacement process.
+For each tag, the application presents a replacement dialog allowing the user to customize replacement text.
+Optional: Users can save and load data using the provided buttons in the GUI.
+Getting Started
+Clone this repository.
+Build and run the application using your preferred Java IDE or command-line tools.
+Configuration
+Configuration settings are stored in the trtconfig.json file. Modify this file to adjust database connections, table names, and other parameters.
+
+Contributing
+Contributions to this project are welcome. Feel free to submit bug reports, feature requests, and pull requests.
+
+License
+This project is licensed under the MIT License.
+