diff --git a/README.md b/README.md
index ac30d09..6c2abda 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,30 @@
-# CMS
\ No newline at end of file
+# CMS
+# CMS - Computational Modeling for Science
+
+## Overview
+CMS is a project under the ML4SCI organization focused on developing computational models for scientific research.  
+This repository contains Jupyter notebooks and scripts that demonstrate machine learning workflows applied to scientific problems.
+
+## Features
+- Jupyter notebooks demonstrating ML workflows
+- Example scripts for computational modeling
+- Placeholder for future datasets and experiments
+
+## Installation
+
+1. **Clone the repository**:
+```bash
+git clone https://github.com/<your-username>/CMS.git
+cd CMS
+Create a virtual environment (recommended):
+
+python -m venv venv
+# On Linux/Mac:
+source venv/bin/activate
+# On Windows:
+venv\Scripts\activate
+
+
+Install dependencies (if requirements.txt exists):
+
+pip install -r requirements.txt