diff --git a/README.md b/README.md
index 98d7492..d42cb3f 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,199 @@
-# property-aggregator
\ No newline at end of file
+[![Contributors][contributors-shield]][contributors-url]
+[![Forks][forks-shield]][forks-url]
+[![Stargazers][stars-shield]][stars-url]
+[![Issues][issues-shield]][issues-url]
+[![MIT License][license-shield]][license-url]
+[![LinkedIn][linkedin-shield]][linkedin-url]
+
+
+
+<br />
+<div align="center">
+  <h3 align="center">Property aggregator</h3>
+  <img src="assets/logo.png"> <br>
+  <strong align="center">
+    Property aggregator is an application for collecting offers for the purchase or rental of apartments, houses, garages, premises and much more.
+    The project consists of 2 main modules: RESTAPI, Scraper CLI application.
+    The data is collected from the two largest advertising websites in Poland: OLX and Otodom
+    <br />
+    <br />
+    <a href="https://github.com/DEENUU1/property-aggregator/issues">Report Bug</a>
+    ·
+    <a href="https://github.com/DEENUU1/property-aggregator/issues">Request Feature</a>
+  </strong>
+</div>
+
+
+## About the project
+This project consists of two separated modules:
+1. A REST API interface built using FastAPI framework, utilizing a PostgreSQL database. Additionally, it employs Celery, Redis and Flower for Celery monitoring.
+2. Scraper: A CLI application for scraping and processing data from platforms such as Otodom and OLX
+
+### FastAPI
+<img src="assets/rest.drawio.png" alt="rest-diagram">
+
+**Offer Filtering and Sorting**: Users can conveniently filter and sort offers based on various parameters to find the most relevant listings.
+
+**JWT Implementation**: The application incorporates JSON Web Tokens (JWT) for secure authentication and authorization processes, ensuring data integrity and user privacy.
+
+**Favorite Offer Saving**: Users have the option to save their preferred offers to a favorites list for easy access and tracking.
+
+**Saved Filters** with Notifications: Users can save their applied filters, enabling them to receive daily notifications within the app and via email about new offers matching their specified criteria.
+
+**Notification Management**: Users can view, modify, or delete saved filters and read notifications directly on the website. The application supports an unlimited number of filters to cater to diverse user preferences.
+
+**Administrative Insights**: Administrators gain access to comprehensive statistics including:
+- Total number of offers added in a specific month.
+- Distribution of offers across different categories.
+- Breakdown of offers available for sale or rent.
+- Monthly user registration count.
+
+
+<img src="assets/123.png" alt="endpoints">
+
+
+### Scrapers
+<img src="assets/scraper.drawio.png" alt="scraper-diagram">
+
+The "Scraper" is a **console application** designed to gather data from various advertising websites such as **OLX** and **Otodom**. 
+It operates by utilizing the **requests** library to fetch data from these websites, after which the collected information is stored in a **MongoDB** database.
+Following the initial data collection phase, the application retrieves the stored data from the NoSQL database. 
+Subsequently, it undergoes parsing to extract the required information. 
+Finally, utilizing an API interface, the parsed data is transmitted to a designated website where it is then saved to a PostgreSQL database.
+This streamlined process ensures efficient extraction, storage, and transfer of data, facilitating seamless integration with the PostgreSQL database for further analysis and utilization.
+
+#### Scraper commands
+```text
+delete-parsed-olx 
+
+# This command allows to remove all parsed objects from MongoDB database in OLX collection
+```
+
+```text
+delete-parsed-otodom 
+
+# This command allows to remove all parsed objects from MongoDB database in Otodom collection
+```
+
+```text
+scrape-otodom 
+
+# This command allows to scrape data from otodom website
+```
+
+```text
+scrape-olx 
+
+# This command allows to scrape data from olx website 
+```
+
+```text
+parse-otodom 
+
+# This command allows to parse scraped data from otodom website
+```
+
+```text
+parse-olx 
+
+# This command allows to parse scraped data from olx website
+```
+
+## Technologies:
+- Python
+    - FastAPI
+    - Celery
+    - Flower
+    - Pytest
+    - Requests
+    - Beautiful Soup 4
+    - Typer
+- PostgreSQL
+- Mongodb
+- SQLite
+- Docker
+- Docker Compose
+- Redis
+- CI/CD
+
+
+
+## Installation
+
+### General
+#### Clone repository
+```bash
+git clone https://github.com/DEENUU1/property-aggregator.git
+```
+
+#### Create .env file
+```bash
+cp .env_example .env
+```
+
+
+### REST API
+#### Build docker-compose 
+```bash
+docker-compose -f docker-compose.dev.yml build
+```
+
+#### Run containers
+```bash
+docker-compose -f docker-compose.dev.yml up
+```
+
+### Scrapers
+#### Build Docker image
+```bash
+docker build -f Dockerfile_scraper -t scraper .
+```
+
+#### Run specified command
+```bash
+docker run scraper scrape-olx
+```
+
+## Authors
+
+- [@DEENUU1](https://www.github.com/DEENUU1)
+
+<!-- LICENSE -->
+
+## License
+
+See `LICENSE.txt` for more information.
+
+
+<!-- MARKDOWN LINKS & IMAGES -->
+<!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->
+
+[contributors-shield]: https://img.shields.io/github/contributors/DEENUU1/property-aggregator.svg?style=for-the-badge
+
+[contributors-url]: https://github.com/DEENUU1/property-aggregator/graphs/contributors
+
+[forks-shield]: https://img.shields.io/github/forks/DEENUU1/property-aggregator.svg?style=for-the-badge
+
+[forks-url]: https://github.com/DEENUU1/property-aggregator/network/members
+
+[stars-shield]: https://img.shields.io/github/stars/DEENUU1/property-aggregator.svg?style=for-the-badge
+
+[stars-url]: https://github.com/DEENUU1/property-aggregator/stargazers
+
+[issues-shield]: https://img.shields.io/github/issues/DEENUU1/property-aggregator.svg?style=for-the-badge
+
+[issues-url]: https://github.com/DEENUU1/property-aggregator/issues
+
+[license-shield]: https://img.shields.io/github/license/DEENUU1/property-aggregator.svg?style=for-the-badge
+
+[license-url]: https://github.com/DEENUU1/property-aggregator/blob/master/LICENSE.txt
+
+[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
+
+[linkedin-url]: https://linkedin.com/in/kacper-wlodarczyk
+
+[basic]: https://github.com/DEENUU1/property-aggregator/blob/main/assets/v1_2/basic.gif?raw=true
+
+[full]: https://github.com/DEENUU1/property-aggregator/blob/main/assets/v1_2/full.gif?raw=true
+
+[search]: https://github.com/DEENUU1/property-aggregator/blob/main/assets/v1_2/search.gif?raw=true
diff --git a/assets/123.png b/assets/123.png
new file mode 100644
index 0000000..b647fbf
Binary files /dev/null and b/assets/123.png differ
diff --git a/assets/logo.png b/assets/logo.png
new file mode 100644
index 0000000..0803b5a
Binary files /dev/null and b/assets/logo.png differ
diff --git a/assets/rest.drawio.png b/assets/rest.drawio.png
new file mode 100644
index 0000000..75fe9c5
Binary files /dev/null and b/assets/rest.drawio.png differ
diff --git a/assets/scraper.drawio.png b/assets/scraper.drawio.png
new file mode 100644
index 0000000..9921e82
Binary files /dev/null and b/assets/scraper.drawio.png differ