From 16df43309340452a47d89dc6af4d0d64d6ea4b7f Mon Sep 17 00:00:00 2001
From: Amarendra Shendkar <amarshendkar.as@gmail.com>
Date: Wed, 10 Apr 2024 09:48:48 +0530
Subject: [PATCH 01/16] added script

---
 deploy.py | 117 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 117 insertions(+)
 create mode 100644 deploy.py

diff --git a/deploy.py b/deploy.py
new file mode 100644
index 000000000..09408e511
--- /dev/null
+++ b/deploy.py
@@ -0,0 +1,117 @@
+import click
+import json
+import subprocess
+
+mapping = {
+    "Default Setup": {
+        "file": "default.yml",
+        "description": "Required for the application to work. Contains a docker deployment of Django, Celery, and Redis",
+        "parameters": {
+            "DB_NAME": {
+                "help": "If you set up a PG installation, enter the same credentials, leave these to default",
+                "default": "postgres",
+            },
+            "DB_USER": {
+                "help": "If you set up a PG installation, enter the same credentials, leave these to default",
+                "default": "postgres",
+            },
+            "DB_PASSWORD": {
+                "help": "If you set up a PG installation, enter the same credentials, leave these to default",
+                "default": "postgres",
+            },
+            "DB_HOST": {
+                "help": "If you set up a PG installation, enter the same credentials, leave these to default",
+                "default": "db",
+            },
+            "SECRET_KEY": {
+                "help": "Django secret key",
+                "default": "abcd1234",
+            },
+            "AZURE_CONNECTION_STRING": {
+                "help": "AZURE storage string",
+                "default": "",
+            },
+            "LOGS_CONTAINER_NAME": {
+                "help": "Logs container name",
+                "default": "logs",
+            },
+        },
+    },
+}
+
+
+@click.command()
+def run_application():
+    click.echo("Welcome to the application setup CLI!")
+    # click.echo("Default configuration includes Django, Celery, and Redis.")
+    subprocess.run(["docker", "network", "create", "shoonya_backend"], check=True)
+    selected_components = []
+    parameters_dict = {}
+
+    # Ask user if they want PostgreSQL installation
+    install_postgres = click.prompt(
+        "Do you want to include PostgreSQL installation? (Y/N)", default="N"
+    )
+    if install_postgres.upper() == "Y":
+        subprocess.run(
+            ["docker-compose", "-f", "postgres.yml", "up", "--build", "-d"], check=True
+        )
+
+    production = click.prompt(
+        "Do you want to run the application in production mode? (Y/N)", default="N"
+    )
+    if production.upper() == "N":
+        click.echo("Running in production mode")
+        parameters_dict["ENVIRONMENT"] = dict({
+            "ENV" : "dev"
+        })
+    for key, value in mapping.items():
+        choice = click.prompt(
+            f"Do you want to include {key}? ({value['description']}) (Y/N)", default="N"
+        )
+        if choice.upper() == "Y":
+            selected_components.append(key)
+            parameters = value.get("parameters")
+            if parameters:
+                click.echo(f"Please provide values for parameters for {key}:")
+                component_params = {}
+                for param, details in parameters.items():
+                    help_message = details.get("help", "")
+                    default_value = details.get("default", "")
+                    value = click.prompt(
+                        f"Enter value for {param} ({help_message})",
+                        default=default_value,
+                    )
+                    if not value:
+                        value = default_value
+                    component_params[param] = value
+                parameters_dict[key] = component_params
+
+    if parameters_dict:
+        with open("backend/.env", "w") as env_file:
+            for component, params in parameters_dict.items():
+                for param, value in params.items():
+                    env_file.write(f"{param}={value}\n")
+
+    docker_compose_files = [
+        mapping[component]["file"] for component in selected_components
+    ]
+    if docker_compose_files:
+        click.echo("Running Docker Compose...")
+        for file in docker_compose_files:
+            subprocess.run(
+                ["docker-compose", "-f", file, "up", "--build", "-d"], check=True
+            )
+
+        # Run docker-compose logs -f for each file
+        for file in docker_compose_files:
+            subprocess.run(["docker-compose", "-f", file, "logs", "-f"], check=True)
+
+        click.echo("Application setup complete!")
+        subprocess.run(["docker", "ps"], check=True)
+    else:
+        click.echo("No components selected. Exiting.")
+
+
+if __name__ == "__main__":
+    run_application()

From 398e0594264e29cccbfb9e16a15d2569a6964ed8 Mon Sep 17 00:00:00 2001
From: Amarendra Shendkar <amarshendkar.as@gmail.com>
Date: Wed, 10 Apr 2024 09:52:37 +0530
Subject: [PATCH 02/16] added docker compose files for components

---
 cron-docker-compose.yml     | 19 +++++++++
 default-docker-compose.yml  | 81 +++++++++++++++++++++++++++++++++++++
 elk-docker-compose.yml      | 43 ++++++++++++++++++++
 nginx-docker-compose.yml    | 44 ++++++++++++++++++++
 postgres-docker-compose.yml | 27 +++++++++++++
 5 files changed, 214 insertions(+)
 create mode 100644 cron-docker-compose.yml
 create mode 100644 default-docker-compose.yml
 create mode 100644 elk-docker-compose.yml
 create mode 100644 nginx-docker-compose.yml
 create mode 100644 postgres-docker-compose.yml

diff --git a/cron-docker-compose.yml b/cron-docker-compose.yml
new file mode 100644
index 000000000..a06202124
--- /dev/null
+++ b/cron-docker-compose.yml
@@ -0,0 +1,19 @@
+version: '3.3'
+
+services:
+  cron:
+    build: ./cron
+    image: evgeniy-khyst/cron
+    environment:
+      COMPOSE_PROJECT_NAME: "${COMPOSE_PROJECT_NAME}"
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock
+      - ./:/workdir:ro
+    restart: unless-stopped
+    networks:
+      - shoonya_backend
+
+
+networks:
+  shoonya_backend:
+    external: true
\ No newline at end of file
diff --git a/default-docker-compose.yml b/default-docker-compose.yml
new file mode 100644
index 000000000..fe57908a2
--- /dev/null
+++ b/default-docker-compose.yml
@@ -0,0 +1,81 @@
+version: '3.3'
+
+services:
+  web:
+    build: ./backend
+    command: python manage.py runserver 0.0.0.0:8000
+    volumes:
+      - ./backend/:/usr/src/backend/
+      - static_volume:/usr/src/backend/static
+    ports:
+      - 8000:8000
+    depends_on:
+      - redis
+    networks:
+      - shoonya_backend
+  redis:
+    container_name: redis
+    image: "redis"
+    ports:
+      - 6379:6379
+    networks:
+      - shoonya_backend
+
+  celery:
+    container_name: celery-default
+    restart: always
+    build: ./backend
+    command: celery -A shoonya_backend.celery worker -Q default --concurrency=2 --loglevel=info
+    volumes:
+      - ./backend/:/usr/src/backend/
+    depends_on:
+      - redis
+      - web
+    networks:
+      - shoonya_backend
+
+  # This is the additional queue which contains the low-priority celery tasks. We can adjust the concurrency and workers alloted to this container.
+  celery2:
+    container_name: celery-low-priority
+    restart: always
+    build: ./backend
+    command: celery -A shoonya_backend.celery worker -Q functions --concurrency=2 --loglevel=info
+    volumes:
+      - ./backend/:/usr/src/backend/
+    depends_on:
+      - redis
+      - web
+    networks:
+      - shoonya_backend
+
+  # Celery beats - for scheduling daily e-mails
+  celery-beat:
+    build: ./backend
+    command: celery -A shoonya_backend.celery beat --loglevel=info
+    volumes:
+      - ./backend/:/usr/src/backend
+    depends_on:
+      - redis
+      - web
+    networks:
+      - shoonya_backend
+
+  celery3:
+    container_name: celery-reports
+    restart: always
+    build: ./backend
+    command: celery -A shoonya_backend.celery worker -Q reports --concurrency=2 --loglevel=info
+    volumes:
+      - ./backend/:/usr/src/backend/
+    depends_on:
+      - redis
+      - web
+    networks:
+      - shoonya_backend
+
+volumes:
+  static_volume:
+
+networks:
+  shoonya_backend:
+    external: true
\ No newline at end of file
diff --git a/elk-docker-compose.yml b/elk-docker-compose.yml
new file mode 100644
index 000000000..f04d31199
--- /dev/null
+++ b/elk-docker-compose.yml
@@ -0,0 +1,43 @@
+version: '3.3'
+
+services:
+  elasticsearch:
+    container_name: elasticsearch
+    image: docker.elastic.co/elasticsearch/elasticsearch:7.14.0
+    volumes:
+      - ./elasticsearch/elasticsearch.yml:/usr/share/elasticsearch/config/elasticsearch.yml
+      # - elasticsearch_vol:/elasticsearch_data
+    environment:
+      - discovery.type=single-node
+    ports:
+      - "9200:9200"
+      - "9300:9300"
+
+  kibana:
+    container_name: kibana
+    image: docker.elastic.co/kibana/kibana:7.14.0
+    ports:
+      - 5601:5601
+    depends_on:
+      - elasticsearch
+
+  logstash:
+    container_name: logstash
+    image: docker.elastic.co/logstash/logstash:7.14.0
+    hostname: shoonya_dev_logger
+    volumes:
+      - ./logstash_dev.conf:/usr/share/logstash/pipeline/logstash.conf
+      # - logs_vol:/logs
+    extra_hosts:
+      - "elasticsearch:elasticsearch"
+    command: logstash -f /usr/share/logstash/pipeline/logstash.conf
+
+volumes:
+  elasticsearch_vol:
+    external: true
+  logs_vol:
+    external: true
+
+networks:
+  shoonya_backend:
+    external: true
\ No newline at end of file
diff --git a/nginx-docker-compose.yml b/nginx-docker-compose.yml
new file mode 100644
index 000000000..cb4be6d4b
--- /dev/null
+++ b/nginx-docker-compose.yml
@@ -0,0 +1,44 @@
+version: '3.3'
+
+services:
+  nginx:
+    build: ./nginx
+    image: evgeniy-khyst/nginx
+    env_file:
+      - ./config.env
+    volumes:
+      - nginx_conf:/etc/nginx/sites
+      - letsencrypt_certs:/etc/letsencrypt
+      - certbot_acme_challenge:/var/www/certbot
+      - ./vhosts:/etc/nginx/vhosts
+      - static_volume:/backend/static
+    ports:
+      - "80:80"
+      - "443:443"
+    restart: unless-stopped
+    networks:
+      - shoonya_backend
+
+  certbot:
+    build: ./certbot
+    image: evgeniy-khyst/certbot
+    env_file:
+      - ./config.env
+    volumes:
+      - letsencrypt_certs:/etc/letsencrypt
+      - certbot_acme_challenge:/var/www/certbot
+    networks:
+      - shoonya_backend
+
+volumes:
+  nginx_conf:
+    external: true
+  letsencrypt_certs:
+    external: true
+  certbot_acme_challenge:
+  static_volume:
+
+
+networks:
+  shoonya_backend:
+    external: true
\ No newline at end of file
diff --git a/postgres-docker-compose.yml b/postgres-docker-compose.yml
new file mode 100644
index 000000000..dde19b29b
--- /dev/null
+++ b/postgres-docker-compose.yml
@@ -0,0 +1,27 @@
+version: '3.9'
+
+services:
+
+  db:
+    image: postgres
+    restart: always
+    # set shared memory limit when using docker-compose
+    shm_size: 128mb
+    # or set shared memory limit when deploy via swarm stack
+    volumes:
+     - type: tmpfs
+       target: /dev/shm
+       tmpfs:
+         size: 134217728 # 128*2^20 bytes = 128Mb
+    environment:
+      POSTGRES_PASSWORD: postgres
+      POSTGRES_USER: postgres
+      POSTGRES_DB: postgres
+    ports:
+      - 5432:5432
+    networks:
+      - shoonya_backend
+
+networks:
+  shoonya_backend:
+    external: true
\ No newline at end of file

From cc32f6eacaee9ab1435b56acfff510bd94409ada Mon Sep 17 00:00:00 2001
From: Pursottam6003 <rahulsah6003@gmail.com>
Date: Sun, 14 Apr 2024 12:17:34 +0530
Subject: [PATCH 03/16] updated the script for backend deployment

---
 deploy.py | 71 +++++++++++++++++++++++++++++++++++++++++++++++++------
 1 file changed, 64 insertions(+), 7 deletions(-)

diff --git a/deploy.py b/deploy.py
index 09408e511..0426fb730 100644
--- a/deploy.py
+++ b/deploy.py
@@ -2,49 +2,103 @@
 import json
 import subprocess
 
+# mapping = {
+#     "Default Setup": {
+#         "file": "default-docker-compose.yml",
+#         "description": "Required for the application to work. Contains a docker deployment of Django, Celery, and Redis",
+#         "parameters": {
+#             "DB_NAME": {
+#                 "help": "If you set up a PG installation, enter the same credentials, leave these to default",
+#                 "default": "postgres",
+#             },
+#             "DB_USER": {
+#                 "help": "If you set up a PG installation, enter the same credentials, leave these to default",
+#                 "default": "postgres",
+#             },
+#             "DB_PASSWORD": {
+#                 "help": "If you set up a PG installation, enter the same credentials, leave these to default",
+#                 "default": "postgres",
+#             },
+#             "DB_HOST": {
+#                 "help": "If you set up a PG installation, enter the same credentials, leave these to default",
+#                 "default": "db",
+#             },
+#             "SECRET_KEY": {
+#                 "help": "Django secret key",
+#                 "default": "abcd1234",
+#             },
+#             "AZURE_CONNECTION_STRING": {
+#                 "help": "AZURE storage string",
+#                 "default": "AZURE_CONNECTION_STRING=DefaultEndpointsProtocol=https;AccountName=dummydeveloper;AccountKey=hello/Jm+uq4gvGgd5aloGrqVxYnRs/dgPHX0G6U4XmLCtZCIeKyNNK0n3Q9oRDNE+AStMDbqXg==;EndpointSuffix=core.windows.net",
+#             },
+#             "LOGS_CONTAINER_NAME": {
+#                 "help": "Logs container name",
+#                 "default": "logs",
+#             },
+#         },
+#     },
+# }
+
 mapping = {
     "Default Setup": {
-        "file": "default.yml",
+        "file": "default-docker-compose.yml",
         "description": "Required for the application to work. Contains a docker deployment of Django, Celery, and Redis",
         "parameters": {
             "DB_NAME": {
                 "help": "If you set up a PG installation, enter the same credentials, leave these to default",
                 "default": "postgres",
+                "warning": "Please provide a valid database name",
             },
             "DB_USER": {
                 "help": "If you set up a PG installation, enter the same credentials, leave these to default",
                 "default": "postgres",
+                "warning": "Please provide a valid database user",
             },
             "DB_PASSWORD": {
                 "help": "If you set up a PG installation, enter the same credentials, leave these to default",
                 "default": "postgres",
+                "warning": "Please provide a valid database password",
             },
             "DB_HOST": {
                 "help": "If you set up a PG installation, enter the same credentials, leave these to default",
                 "default": "db",
+                "warning": "Please provide a valid database host",
             },
             "SECRET_KEY": {
                 "help": "Django secret key",
                 "default": "abcd1234",
+                "warning": "Please provide a valid secret key",
             },
             "AZURE_CONNECTION_STRING": {
                 "help": "AZURE storage string",
-                "default": "",
+                "default": "AZURE_CONNECTION_STRING=DefaultEndpointsProtocol=https;AccountName=dummydeveloper;AccountKey=hello/Jm+uq4gvGgd5aloGrqVxYnRs/dgPHX0G6U4XmLCtZCIeKyNNK0n3Q9oRDNE+AStMDbqXg==;EndpointSuffix=core.windows.net",
+                "warning": "Please provide a valid Azure connection string",
             },
             "LOGS_CONTAINER_NAME": {
                 "help": "Logs container name",
                 "default": "logs",
+                "warning": "Please provide a valid logs container name",
             },
         },
     },
 }
 
+def handle_error(error_message):
+    click.secho(error_message, fg="red", bold=True)
+    exit(1)
 
 @click.command()
 def run_application():
-    click.echo("Welcome to the application setup CLI!")
+    click.secho("Welcome to the application setup CLI!", fg="green", bold=True)
     # click.echo("Default configuration includes Django, Celery, and Redis.")
-    subprocess.run(["docker", "network", "create", "shoonya_backend"], check=True)
+
+    try: 
+        subprocess.run(["docker", "network", "create", "shoonya_backend"], check=True)
+        click.secho("Network created with the name shoonya_backend", fg="green", bold=True)
+    except subprocess.CalledProcessError:
+        click.secho("Network already exists with the name shoonya. Skipping creation.", fg="yellow")
+
+
     selected_components = []
     parameters_dict = {}
 
@@ -54,7 +108,7 @@ def run_application():
     )
     if install_postgres.upper() == "Y":
         subprocess.run(
-            ["docker-compose", "-f", "postgres.yml", "up", "--build", "-d"], check=True
+            ["docker-compose", "-f", "postgres-docker-compose.yml", "up", "--build", "-d"], check=True
         )
 
     production = click.prompt(
@@ -78,6 +132,7 @@ def run_application():
                 for param, details in parameters.items():
                     help_message = details.get("help", "")
                     default_value = details.get("default", "")
+                    warning = details.get("warning", "")
                     value = click.prompt(
                         f"Enter value for {param} ({help_message})",
                         default=default_value,
@@ -87,6 +142,8 @@ def run_application():
                     component_params[param] = value
                 parameters_dict[key] = component_params
 
+ 
+
     if parameters_dict:
         with open("backend/.env", "w") as env_file:
             for component, params in parameters_dict.items():
@@ -107,10 +164,10 @@ def run_application():
         for file in docker_compose_files:
             subprocess.run(["docker-compose", "-f", file, "logs", "-f"], check=True)
 
-        click.echo("Application setup complete!")
+        click.secho("Application setup complete!", fg="green", bold=True)
         subprocess.run(["docker", "ps"], check=True)
     else:
-        click.echo("No components selected. Exiting.")
+        click.secho("No components selected. Exiting.",fg="red",bold=True)
 
 
 if __name__ == "__main__":

From 8021afcbdea384773ba38d6463c73e866ccee449 Mon Sep 17 00:00:00 2001
From: Pursottam6003 <rahulsah6003@gmail.com>
Date: Tue, 16 Apr 2024 08:55:33 +0530
Subject: [PATCH 04/16] updated the script for any error handling

---
 deploy.py | 196 +++++++++++++++++++++++++-----------------------------
 1 file changed, 90 insertions(+), 106 deletions(-)

diff --git a/deploy.py b/deploy.py
index 0426fb730..4b4a4a917 100644
--- a/deploy.py
+++ b/deploy.py
@@ -1,44 +1,7 @@
 import click
 import json
 import subprocess
-
-# mapping = {
-#     "Default Setup": {
-#         "file": "default-docker-compose.yml",
-#         "description": "Required for the application to work. Contains a docker deployment of Django, Celery, and Redis",
-#         "parameters": {
-#             "DB_NAME": {
-#                 "help": "If you set up a PG installation, enter the same credentials, leave these to default",
-#                 "default": "postgres",
-#             },
-#             "DB_USER": {
-#                 "help": "If you set up a PG installation, enter the same credentials, leave these to default",
-#                 "default": "postgres",
-#             },
-#             "DB_PASSWORD": {
-#                 "help": "If you set up a PG installation, enter the same credentials, leave these to default",
-#                 "default": "postgres",
-#             },
-#             "DB_HOST": {
-#                 "help": "If you set up a PG installation, enter the same credentials, leave these to default",
-#                 "default": "db",
-#             },
-#             "SECRET_KEY": {
-#                 "help": "Django secret key",
-#                 "default": "abcd1234",
-#             },
-#             "AZURE_CONNECTION_STRING": {
-#                 "help": "AZURE storage string",
-#                 "default": "AZURE_CONNECTION_STRING=DefaultEndpointsProtocol=https;AccountName=dummydeveloper;AccountKey=hello/Jm+uq4gvGgd5aloGrqVxYnRs/dgPHX0G6U4XmLCtZCIeKyNNK0n3Q9oRDNE+AStMDbqXg==;EndpointSuffix=core.windows.net",
-#             },
-#             "LOGS_CONTAINER_NAME": {
-#                 "help": "Logs container name",
-#                 "default": "logs",
-#             },
-#         },
-#     },
-# }
-
+ 
 mapping = {
     "Default Setup": {
         "file": "default-docker-compose.yml",
@@ -83,92 +46,113 @@
     },
 }
 
-def handle_error(error_message):
+def echo_error(error_message):
     click.secho(error_message, fg="red", bold=True)
     exit(1)
 
+def echo_success(success_message):
+    click.secho(success_message, fg="green", bold=True)
+
+def echo_warning(warning_message):
+    click.secho(warning_message, fg="yellow", bold=True)
+
 @click.command()
 def run_application():
-    click.secho("Welcome to the application setup CLI!", fg="green", bold=True)
-    # click.echo("Default configuration includes Django, Celery, and Redis.")
+    echo_success("Welcome to the application setup CLI!")
 
     try: 
         subprocess.run(["docker", "network", "create", "shoonya_backend"], check=True)
-        click.secho("Network created with the name shoonya_backend", fg="green", bold=True)
+        echo_success("Network created with the name shoonya_backend")
     except subprocess.CalledProcessError:
-        click.secho("Network already exists with the name shoonya. Skipping creation.", fg="yellow")
+        echo_warning("Network already exists with the name shoonya. Skipping creation.")
 
 
     selected_components = []
     parameters_dict = {}
 
-    # Ask user if they want PostgreSQL installation
-    install_postgres = click.prompt(
-        "Do you want to include PostgreSQL installation? (Y/N)", default="N"
-    )
-    if install_postgres.upper() == "Y":
-        subprocess.run(
-            ["docker-compose", "-f", "postgres-docker-compose.yml", "up", "--build", "-d"], check=True
-        )
-
-    production = click.prompt(
-        "Do you want to run the application in production mode? (Y/N)", default="N"
-    )
-    if production.upper() == "N":
-        click.echo("Running in production mode")
-        parameters_dict["ENVIRONMENT"] = dict({
-            "ENV" : "dev"
-        })
-    for key, value in mapping.items():
-        choice = click.prompt(
-            f"Do you want to include {key}? ({value['description']}) (Y/N)", default="N"
+    try : 
+        # Ask user if they want PostgreSQL installation
+        install_postgres = click.prompt(
+            "Do you want to include PostgreSQL installation? (Y/N)", default="N"
         )
-        if choice.upper() == "Y":
-            selected_components.append(key)
-            parameters = value.get("parameters")
-            if parameters:
-                click.echo(f"Please provide values for parameters for {key}:")
-                component_params = {}
-                for param, details in parameters.items():
-                    help_message = details.get("help", "")
-                    default_value = details.get("default", "")
-                    warning = details.get("warning", "")
-                    value = click.prompt(
-                        f"Enter value for {param} ({help_message})",
-                        default=default_value,
-                    )
-                    if not value:
-                        value = default_value
-                    component_params[param] = value
-                parameters_dict[key] = component_params
-
- 
-
-    if parameters_dict:
-        with open("backend/.env", "w") as env_file:
-            for component, params in parameters_dict.items():
-                for param, value in params.items():
-                    env_file.write(f"{param}={value}\n")
-
-    docker_compose_files = [
-        mapping[component]["file"] for component in selected_components
-    ]
-    if docker_compose_files:
-        click.echo("Running Docker Compose...")
-        for file in docker_compose_files:
+        if install_postgres.upper() == "Y":
             subprocess.run(
-                ["docker-compose", "-f", file, "up", "--build", "-d"], check=True
+                ["docker-compose", "-f", "postgres-docker-compose.yml", "up", "--build", "-d"], check=True
             )
 
-        # Run docker-compose logs -f for each file
-        for file in docker_compose_files:
-            subprocess.run(["docker-compose", "-f", file, "logs", "-f"], check=True)
-
-        click.secho("Application setup complete!", fg="green", bold=True)
-        subprocess.run(["docker", "ps"], check=True)
-    else:
-        click.secho("No components selected. Exiting.",fg="red",bold=True)
-
+        production = click.prompt(
+            "Do you want to run the application in production mode? (Y/N)", default="N"
+        )
+        if production.upper() == "N":
+            click.echo("Running in production mode")
+            parameters_dict["ENVIRONMENT"] = dict({
+                "ENV" : "dev"
+            })
+        for key, value in mapping.items():
+            choice = click.prompt(
+                f"Do you want to include {key}? ({value['description']}) (Y/N)", default="N"
+            )
+            if choice.upper() == "Y":
+                selected_components.append(key)
+                parameters = value.get("parameters")
+                if parameters:
+                    click.echo(f"Please provide values for parameters for {key}:")
+                    component_params = {}
+                    for param, details in parameters.items():
+                        help_message = details.get("help", "")
+                        default_value = details.get("default", "")
+                        warning = details.get("warning", "")
+                        value = click.prompt(
+                            f"Enter value for {param} ({help_message})",
+                            default=default_value,
+                        )
+                        if not value:
+                            value = default_value
+                        component_params[param] = value
+                    parameters_dict[key] = component_params
+        if parameters_dict:
+            with open("backend/.env", "w") as env_file:
+                for component, params in parameters_dict.items():
+                    for param, value in params.items():
+                        env_file.write(f"{param}={value}\n")
+
+        docker_compose_files = [
+            mapping[component]["file"] for component in selected_components
+        ]
+        if docker_compose_files:
+            click.echo("Running Docker Compose...")
+            for file in docker_compose_files:
+                subprocess.run(
+                    ["docker-compose", "-f", file, "up", "--build", "-d"], check=True
+                )
+
+            # Run docker-compose logs -f for each file
+            for file in docker_compose_files:
+                subprocess.run(["docker-compose", "-f", file, "logs", "-f"], check=True)
+
+            echo_success("Application setup complete!")
+            subprocess.run(["docker", "ps"], check=True)
+        else:
+            echo_error("No components selected. Exiting.")
+
+
+    except Exception as e:
+        print(f"An error occurred: {e}")
+        echo_error("An error occurred. Exiting. ")
+        echo_error("Stopping all running containers...")
+        if docker_compose_files:
+            for file in docker_compose_files:
+                subprocess.run(
+                    ["docker-compose", "-f", file, "down"], check=True
+                )
+
+            # Run docker-compose logs -f for each file
+            for file in docker_compose_files:
+                subprocess.run(["docker-compose", "-f", file, "logs", "-f"], check=True)
+
+        else:
+            echo_error("No components selected. Exiting.")
+        exit(1)
 
 if __name__ == "__main__":
     run_application()

From 0949b37c600bcffea96872351425adc95b8a84c0 Mon Sep 17 00:00:00 2001
From: Amarendra Shendkar <amarshendkar.as@gmail.com>
Date: Tue, 16 Apr 2024 09:59:07 +0530
Subject: [PATCH 05/16] added dockerized deployment instructions to readme

---
 README.md | 60 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 58 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index e093b8b17..5281a3da1 100644
--- a/README.md
+++ b/README.md
@@ -71,7 +71,61 @@ GOOGLE_APPLICATION_CREDENTIALS="/path/to/gcloud-key.json"
 
 ### Docker Installation
 
-`cd` back to the root folder .Once inside, build the docker containers:
+
+
+
+```markdown
+# Application Setup Guide
+
+This guide will walk you through setting up the application using different methods and components.
+
+## Running the Script
+
+To run the setup script, follow these steps:
+
+1. Clone this repository to your local machine.
+2. Navigate to the repository directory.
+3. Run the following command:
+
+   ```bash
+   python setup.py
+   ```
+
+4. Follow the prompts to select components and provide required parameters.
+
+## Components
+
+### Default Setup
+
+- **Description:** Required for the application to work. Contains a docker deployment of Django, Celery, and Redis.
+  
+  **Parameters:**
+  - `DB_NAME`
+    - **Description:** Database name.
+    - **Default:** `postgres`
+  - `DB_USER`
+    - **Description:** Database user.
+    - **Default:** `postgres`
+  - `DB_PASSWORD`
+    - **Description:** Database password.
+    - **Default:** `postgres`
+  - `DB_HOST`
+    - **Description:** Database host.
+    - **Default:** `db`
+  - `SECRET_KEY`
+    - **Description:** Django secret key.
+    - **Default:** `abcd1234`
+  - `AZURE_CONNECTION_STRING`
+    - **Description:** Azure storage string.
+    - **Default:** `AZURE_CONNECTION_STRING=DefaultEndpointsProtocol=https;AccountName=dummydeveloper;AccountKey=hello/Jm+uq4gvGgd5aloGrqVxYnRs/dgPHX0G6U4XmLCtZCIeKyNNK0n3Q9oRDNE+AStMDbqXg==;EndpointSuffix=core.windows.net`
+  - `LOGS_CONTAINER_NAME`
+    - **Description:** Logs container name.
+    - **Default:** `logs`
+
+
+
+
+<!-- `cd` back to the root folder .Once inside, build the docker containers:
 
 ```bash
 docker-compose -f docker-compose-local.yml build
@@ -97,7 +151,9 @@ docker-compose exec web python manage.py migrate
 # Create a superuser
 docker-compose exec web python manage.py createsuperuser
 
-```
+``` -->
+
+
 
 If there were no errors, congratulations! The project is up and running.
 

From 0719265491aa2588d4236f53417ad922fce7c011 Mon Sep 17 00:00:00 2001
From: Amarendra Shendkar <amarshendkar.as@gmail.com>
Date: Tue, 16 Apr 2024 14:54:43 +0530
Subject: [PATCH 06/16] added components to mapping

---
 NewReadme.md |   0
 deploy.py    | 123 ++++++++++++++++++++++++++++++++++++++++++++-------
 2 files changed, 107 insertions(+), 16 deletions(-)
 create mode 100644 NewReadme.md

diff --git a/NewReadme.md b/NewReadme.md
new file mode 100644
index 000000000..e69de29bb
diff --git a/deploy.py b/deploy.py
index 4b4a4a917..62cc0eef8 100644
--- a/deploy.py
+++ b/deploy.py
@@ -2,28 +2,28 @@
 import json
 import subprocess
  
-mapping = {
+component_mapping = {
     "Default Setup": {
         "file": "default-docker-compose.yml",
         "description": "Required for the application to work. Contains a docker deployment of Django, Celery, and Redis",
         "parameters": {
             "DB_NAME": {
-                "help": "If you set up a PG installation, enter the same credentials, leave these to default",
+                "help": "If you set up a PG installation, leave these to default",
                 "default": "postgres",
                 "warning": "Please provide a valid database name",
             },
             "DB_USER": {
-                "help": "If you set up a PG installation, enter the same credentials, leave these to default",
+                "help": "If you set up a PG installation, leave these to default",
                 "default": "postgres",
                 "warning": "Please provide a valid database user",
             },
             "DB_PASSWORD": {
-                "help": "If you set up a PG installation, enter the same credentials, leave these to default",
+                "help": "If you set up a PG installation, leave these to default",
                 "default": "postgres",
                 "warning": "Please provide a valid database password",
             },
             "DB_HOST": {
-                "help": "If you set up a PG installation, enter the same credentials, leave these to default",
+                "help": "If you set up a PG installation, leave these to default",
                 "default": "db",
                 "warning": "Please provide a valid database host",
             },
@@ -44,6 +44,91 @@
             },
         },
     },
+    "Elasticsearch-Logstash-Kibana": {
+        "file": "elk-docker-compose.yml",
+        "description": "ELK stack for logging monitoring etc",
+        "parameters": {
+            "ELASTICSEARCH_URL": {
+                "help": "url for elasticsearch",
+                "default": "elasticsearch:9200",
+                "warning": "Please provide a valid elasticsearch endpoint",
+            },
+            "INDEX_NAME": {
+                "help": "",
+                "default": "",
+                "warning": "",
+            }
+        },
+    },
+    "Email Service": {
+        "description": "Required for the application to work. Contains a docker deployment of Django, Celery, and Redis",
+        "parameters": {
+            "EMAIL_HOST": {
+                "help": "If you set up a PG installation, leave these to default",
+                "default": "postgres",
+                "warning": "Please provide a valid database name",
+            },
+            "SMTP_USERNAME": {
+                "help": "If you set up a PG installation, leave these to default",
+                "default": "postgres",
+                "warning": "Please provide a valid database user",
+            },
+            "SMTP_PASSWORD": {
+                "help": "If you set up a PG installation, leave these to default",
+                "default": "postgres",
+                "warning": "Please provide a valid database password",
+            },
+            "DEFAULT_FROM_EMAIL": {
+                "help": "If you set up a PG installation, leave these to default",
+                "default": "db",
+                "warning": "Please provide a valid database host",
+            }
+        },
+    },
+    "Logging": {
+        
+        "description": "Required for the application to work. Contains a docker deployment of Django, Celery, and Redis",
+        "parameters": {
+            "LOGGING": {
+                "help": "If you set up a PG installation, leave these to default",
+                "default": "postgres",
+                "warning": "Please provide a valid database name",
+            },
+            "LOG_LEVEL": {
+                "help": "If you set up a PG installation, leave these to default",
+                "default": "postgres",
+                "warning": "Please provide a valid database user",
+            }
+        },
+    },
+    "MINIO": {
+        "description": "Required for the application to work. Contains a docker deployment of Django, Celery, and Redis",
+        "parameters": {
+            "MINIO_ACCESS_KEY": {
+                "help": "",
+                "default": "",
+                "warning": "",
+            },
+            "MINIO_SECRET_KEY": {
+                "help": "",
+                "default": "",
+                "warning": "",
+            },
+            "MINIO_ENDPOINT": {
+                "help": "",
+                "default": "",
+                "warning": "",
+            },
+        },
+    }  
+}
+
+environment = {
+    "ENVIRONMENT": {
+        "default" : "dev",
+        "help": "The environment in which the application is running. PROD : Production, DEV : Development"
+    },
+
 }
 
 def echo_error(error_message):
@@ -68,9 +153,18 @@ def run_application():
 
 
     selected_components = []
+    docker_compose_files = []
     parameters_dict = {}
 
     try : 
+        production = click.prompt(
+            "Do you want to run the application in production mode? (Y/N)", default="N"
+        )
+        if production.upper() == "N":
+            click.echo("Running in development mode")
+            parameters_dict["ENVIRONMENT"] = dict({
+                "ENV" : "dev"
+            })
         # Ask user if they want PostgreSQL installation
         install_postgres = click.prompt(
             "Do you want to include PostgreSQL installation? (Y/N)", default="N"
@@ -80,20 +174,17 @@ def run_application():
                 ["docker-compose", "-f", "postgres-docker-compose.yml", "up", "--build", "-d"], check=True
             )
 
-        production = click.prompt(
-            "Do you want to run the application in production mode? (Y/N)", default="N"
-        )
-        if production.upper() == "N":
-            click.echo("Running in production mode")
-            parameters_dict["ENVIRONMENT"] = dict({
-                "ENV" : "dev"
-            })
+        
         for key, value in mapping.items():
             choice = click.prompt(
                 f"Do you want to include {key}? ({value['description']}) (Y/N)", default="N"
             )
             if choice.upper() == "Y":
                 selected_components.append(key)
+                #modify the next line such that it only appends if there is a key called "file" in the value
+                if "file" in value:
+                    docker_compose_files.append(value["file"])
+                 
                 parameters = value.get("parameters")
                 if parameters:
                     click.echo(f"Please provide values for parameters for {key}:")
@@ -106,6 +197,7 @@ def run_application():
                             f"Enter value for {param} ({help_message})",
                             default=default_value,
                         )
+
                         if not value:
                             value = default_value
                         component_params[param] = value
@@ -116,9 +208,7 @@ def run_application():
                     for param, value in params.items():
                         env_file.write(f"{param}={value}\n")
 
-        docker_compose_files = [
-            mapping[component]["file"] for component in selected_components
-        ]
+        
         if docker_compose_files:
             click.echo("Running Docker Compose...")
             for file in docker_compose_files:
@@ -156,3 +246,4 @@ def run_application():
 
 if __name__ == "__main__":
     run_application()
+ 
\ No newline at end of file

From acf7fb45f78f68c955c61488a29061b25148770d Mon Sep 17 00:00:00 2001
From: Amarendra Shendkar <amarshendkar.as@gmail.com>
Date: Tue, 16 Apr 2024 22:45:04 +0530
Subject: [PATCH 07/16] added parameters for most components in the mapping

---
 deploy.py | 196 ++++++++++++++++++++++++++++++++++++++++++++++--------
 1 file changed, 170 insertions(+), 26 deletions(-)

diff --git a/deploy.py b/deploy.py
index 62cc0eef8..5289863f8 100644
--- a/deploy.py
+++ b/deploy.py
@@ -1,7 +1,7 @@
 import click
 import json
 import subprocess
- 
+
 component_mapping = {
     "Default Setup": {
         "file": "default-docker-compose.yml",
@@ -27,6 +27,11 @@
                 "default": "db",
                 "warning": "Please provide a valid database host",
             },
+            "CELERY_BROKER_URL": {
+                "help": "Broker for celery tasks",
+                "default": "redis://redis:6379/0",
+                "warning": "",
+            },
             "SECRET_KEY": {
                 "help": "Django secret key",
                 "default": "abcd1234",
@@ -44,6 +49,26 @@
             },
         },
     },
+    "Nginx_Certbot": {
+        "description": "Nginx and Certbot setup for serving HTTPS traffic",
+        "parameters": {
+            "DOMAINS": {
+                "help": "Domains for which the certificates will be obtained",
+                "default": "",
+                "warning": "Please provide valid domains",
+            },
+            "CERTBOT_TEST_CERT": {
+                "help": "Whether to use Certbot's test certificate",
+                "default": "0",
+                "warning": "",
+            },
+            "CERTBOT_RSA_KEY_SIZE": {
+                "help": "Size of RSA key for the certificate",
+                "default": "4096",
+                "warning": "",
+            },
+        },
+    },
     "Elasticsearch-Logstash-Kibana": {
         "file": "elk-docker-compose.yml",
         "description": "ELK stack for logging monitoring etc",
@@ -57,7 +82,123 @@
                 "help": "",
                 "default": "",
                 "warning": "",
-            }
+            },
+        },
+    },
+    "Flower": {
+        "file": "flower-docker-compose.yml",
+        "description": "Flower for monitoring celery tasks",
+        "parameters": {
+            "FLOWER_ADDRESS": {
+                "help": "Address for accessing Flower",
+                "default": "flower",
+                "warning": "Please provide a valid Flower address",
+            },
+            "FLOWER_PORT": {
+                "help": "Port for accessing Flower",
+                "default": "5555",
+                "warning": "Please provide a valid port number for Flower",
+            },
+            "FLOWER_USERNAME": {
+                "help": "Username for Flower",
+                "default": "shoonya",
+                "warning": "Please provide a valid username for Flower",
+            },
+            "FLOWER_PASSWORD": {
+                "help": "Password for Flower",
+                "default": "flower123",
+                "warning": "Please provide a valid password for Flower",
+            },
+        },
+    },
+    "Google_Application_Credentials": {
+        "description": "Google Application Credentials for accessing Google APIs",
+        "parameters": {
+            "type": {
+                "help": "Type of service account",
+                "default": "",
+                "warning": "Please provide a valid type",
+            },
+            "project_id": {
+                "help": "Project ID",
+                "default": "",
+                "warning": "Please provide a valid project ID",
+            },
+            "private_key_id": {
+                "help": "Private key ID",
+                "default": "",
+                "warning": "Please provide a valid private key ID",
+            },
+            "private_key": {
+                "help": "Private key",
+                "default": "",
+                "warning": "Please provide a valid private key",
+            },
+            "client_email": {
+                "help": "Client email",
+                "default": "",
+                "warning": "Please provide a valid client email",
+            },
+            "client_id": {
+                "help": "Client ID",
+                "default": "",
+                "warning": "Please provide a valid client ID",
+            },
+            "auth_uri": {
+                "help": "Authorization URI",
+                "default": "",
+                "warning": "Please provide a valid authorization URI",
+            },
+            "token_uri": {
+                "help": "Token URI",
+                "default": "",
+                "warning": "Please provide a valid token URI",
+            },
+            "auth_provider_x509_cert_url": {
+                "help": "Auth provider X.509 certificate URL",
+                "default": "",
+                "warning": "Please provide a valid Auth provider X.509 certificate URL",
+            },
+            "client_x509_cert_url": {
+                "help": "Client X.509 certificate URL",
+                "default": "",
+                "warning": "Please provide a valid Client X.509 certificate URL",
+            },
+            "universe_domain": {
+                "help": "Universe domain",
+                "default": "",
+                "warning": "Please provide a valid universe domain",
+            },
+        },
+    },
+    "Ask_Dhruva": {
+        "description": "Component for interacting with Dhruva ASR service",
+        "parameters": {
+            "ASR_DHRUVA_URL": {
+                "help": "URL for Dhruva ASR service",
+                "default": "",
+                "warning": "Please provide a valid Dhruva ASR service URL",
+            },
+            "ASR_DHRUVA_AUTHORIZATION": {
+                "help": "Authorization token for Dhruva ASR service",
+                "default": "",
+                "warning": "Please provide a valid authorization token for Dhruva ASR service",
+            },
+        },
+    },
+    "Indic_Trans_V2": {
+        "description": "Component for interacting with Indic Trans V2 service",
+        "parameters": {
+            "INDIC_TRANS_V2_KEY": {
+                "help": "API key for Indic Trans V2 service",
+                "default": "",
+                "warning": "Please provide a valid API key for Indic Trans V2 service",
+            },
+            "INDIC_TRANS_V2_URL": {
+                "help": "URL for Indic Trans V2 service",
+                "default": "",
+                "warning": "Please provide a valid URL for Indic Trans V2 service",
+            },
         },
     },
     "Email Service": {
@@ -82,11 +223,10 @@
                 "help": "If you set up a PG installation, leave these to default",
                 "default": "db",
                 "warning": "Please provide a valid database host",
-            }
+            },
         },
     },
     "Logging": {
-        
         "description": "Required for the application to work. Contains a docker deployment of Django, Celery, and Redis",
         "parameters": {
             "LOGGING": {
@@ -98,7 +238,7 @@
                 "help": "If you set up a PG installation, leave these to default",
                 "default": "postgres",
                 "warning": "Please provide a valid database user",
-            }
+            },
         },
     },
     "MINIO": {
@@ -120,71 +260,79 @@
                 "warning": "",
             },
         },
-    }  
+    },
 }
 
 environment = {
     "ENVIRONMENT": {
-        "default" : "dev",
-        "help": "The environment in which the application is running. PROD : Production, DEV : Development"
+        "default": "dev",
+        "help": "The environment in which the application is running. PROD : Production, DEV : Development",
     },
-
 }
 
+
 def echo_error(error_message):
     click.secho(error_message, fg="red", bold=True)
     exit(1)
 
+
 def echo_success(success_message):
     click.secho(success_message, fg="green", bold=True)
 
+
 def echo_warning(warning_message):
     click.secho(warning_message, fg="yellow", bold=True)
 
+
 @click.command()
 def run_application():
     echo_success("Welcome to the application setup CLI!")
 
-    try: 
+    try:
         subprocess.run(["docker", "network", "create", "shoonya_backend"], check=True)
         echo_success("Network created with the name shoonya_backend")
     except subprocess.CalledProcessError:
         echo_warning("Network already exists with the name shoonya. Skipping creation.")
 
-
     selected_components = []
     docker_compose_files = []
     parameters_dict = {}
 
-    try : 
+    try:
         production = click.prompt(
             "Do you want to run the application in production mode? (Y/N)", default="N"
         )
         if production.upper() == "N":
             click.echo("Running in development mode")
-            parameters_dict["ENVIRONMENT"] = dict({
-                "ENV" : "dev"
-            })
+            parameters_dict["ENVIRONMENT"] = dict({"ENV": "dev"})
         # Ask user if they want PostgreSQL installation
         install_postgres = click.prompt(
             "Do you want to include PostgreSQL installation? (Y/N)", default="N"
         )
         if install_postgres.upper() == "Y":
             subprocess.run(
-                ["docker-compose", "-f", "postgres-docker-compose.yml", "up", "--build", "-d"], check=True
+                [
+                    "docker-compose",
+                    "-f",
+                    "postgres-docker-compose.yml",
+                    "up",
+                    "--build",
+                    "-d",
+                ],
+                check=True,
             )
 
-        
         for key, value in mapping.items():
             choice = click.prompt(
-                f"Do you want to include {key}? ({value['description']}) (Y/N)", default="N"
+                f"Do you want to include {key}? ({value['description']}) (Y/N)",
+                default="N",
             )
             if choice.upper() == "Y":
                 selected_components.append(key)
-                #modify the next line such that it only appends if there is a key called "file" in the value
+                # modify the next line such that it only appends if there is a key called "file" in the value
                 if "file" in value:
                     docker_compose_files.append(value["file"])
-                 
+
                 parameters = value.get("parameters")
                 if parameters:
                     click.echo(f"Please provide values for parameters for {key}:")
@@ -208,7 +356,6 @@ def run_application():
                     for param, value in params.items():
                         env_file.write(f"{param}={value}\n")
 
-        
         if docker_compose_files:
             click.echo("Running Docker Compose...")
             for file in docker_compose_files:
@@ -225,16 +372,13 @@ def run_application():
         else:
             echo_error("No components selected. Exiting.")
 
-
     except Exception as e:
         print(f"An error occurred: {e}")
         echo_error("An error occurred. Exiting. ")
         echo_error("Stopping all running containers...")
         if docker_compose_files:
             for file in docker_compose_files:
-                subprocess.run(
-                    ["docker-compose", "-f", file, "down"], check=True
-                )
+                subprocess.run(["docker-compose", "-f", file, "down"], check=True)
 
             # Run docker-compose logs -f for each file
             for file in docker_compose_files:
@@ -244,6 +388,6 @@ def run_application():
             echo_error("No components selected. Exiting.")
         exit(1)
 
+
 if __name__ == "__main__":
     run_application()
- 
\ No newline at end of file

From 8c1d02ff8348840fe3978bfcf6f42e57d6c9b5c5 Mon Sep 17 00:00:00 2001
From: Amarendra Shendkar <amarshendkar.as@gmail.com>
Date: Tue, 16 Apr 2024 23:37:53 +0530
Subject: [PATCH 08/16] added new readme draft

---
 NewReadme.md | 140 +++++++++++++++++++++++++++++++++++++++++++++++++++
 deploy.py    |  30 +++++++----
 2 files changed, 160 insertions(+), 10 deletions(-)

diff --git a/NewReadme.md b/NewReadme.md
index e69de29bb..d1c0c5ce7 100644
--- a/NewReadme.md
+++ b/NewReadme.md
@@ -0,0 +1,140 @@
+# Shoonya Backend
+
+Repository for Shoonya's backend.
+
+## Pre-requisites
+
+The project was created using [Python 3.7](https://www.python.org/downloads/). All major dependencies along with the versions are listed in the `backend/deploy/requirements.txt` file.
+
+## Installation
+
+
+
+# Project Name README
+
+## Prerequisites
+- Docker Engine/Docker Desktop running
+
+## Database Setup
+To set up a PostgreSQL container:
+- When prompted during the script execution, enter 'Y' to include PostgreSQL installation.
+- Alternatively, manually provide the following database variables in the `.env` file:
+  - `DB_NAME`
+  - `DB_USER`
+  - `DB_PASSWORD`
+  - `DB_HOST`
+
+## Default Components
+This section includes the default setup required for the application to work. It contains Docker deployments of Django, Celery, and Redis.
+
+### Django
+- Description: Django is a high-level Python web framework.
+- Configuration:
+  - `SECRET_KEY`: Django secret key
+
+### Celery
+- Description: Celery is an asynchronous task queue/job queue based on distributed message passing.
+- Configuration:
+  - `CELERY_BROKER_URL`: Broker for Celery tasks
+
+### Redis
+- Description: Redis is an open-source, in-memory data structure store used as a database, cache, and message broker.
+- Configuration: None
+
+## Elasticsearch-Logstash-Kibana
+This section contains the ELK stack for logging monitoring etc.
+
+- Elasticsearch
+  - Description: Elasticsearch is a distributed, RESTful search and analytics engine.
+  - Configuration:
+    - `ELASTICSEARCH_URL`: URL for Elasticsearch
+    - `INDEX_NAME`: Index name
+
+- Logstash
+  - Description: Logstash is a server-side data processing pipeline that ingests data from multiple sources simultaneously, transforms it, and then sends it to a "stash" like Elasticsearch.
+  - Configuration: None
+
+- Kibana
+  - Description: Kibana is an open-source data visualization dashboard for Elasticsearch.
+  - Configuration: None
+
+## Nginx-Certbot
+This section contains Nginx and Certbot setup for serving HTTPS traffic.
+
+- Nginx
+  - Description: Nginx is a web server that can also be used as a reverse proxy, load balancer, mail proxy, and HTTP cache.
+  - Configuration: None
+
+- Certbot
+  - Description: Certbot is a free, open-source software tool for automatically using Let's Encrypt certificates on manually-administrated websites to enable HTTPS.
+  - Configuration: None
+
+## Additional Services
+
+### Google Application Credentials
+- Description: Google Application Credentials for accessing Google APIs.
+- Parameters:
+  - `type`
+  - `project_id`
+  - `private_key_id`
+  - `private_key`
+  - `client_email`
+  - `client_id`
+  - `auth_uri`
+  - `token_uri`
+  - `auth_provider_x509_cert_url`
+  - `client_x509_cert_url`
+  - `universe_domain`
+
+### Ask_Dhruva
+- Description: Component for interacting with Dhruva ASR service.
+- Parameters:
+  - `ASR_DHRUVA_URL`: URL for Dhruva ASR service
+  - `ASR_DHRUVA_AUTHORIZATION`: Authorization token for Dhruva ASR service
+
+### Indic_Trans_V2
+- Description: Component for interacting with Indic Trans V2 service.
+- Parameters:
+  - `INDIC_TRANS_V2_KEY`: API key for Indic Trans V2 service
+  - `INDIC_TRANS_V2_URL`: URL for Indic Trans V2 service
+
+### Email Service
+- Description: Required for the application to work. Contains a Docker deployment of Django, Celery, and Redis.
+- Parameters:
+  - `EMAIL_HOST`
+  - `SMTP_USERNAME`
+  - `SMTP_PASSWORD`
+  - `DEFAULT_FROM_EMAIL`
+
+### Logging
+- Description: Required for the application to work. Contains a Docker deployment of Django, Celery, and Redis.
+- Parameters:
+  - `LOGGING`
+  - `LOG_LEVEL`
+
+### MINIO
+- Description: Required for the application to work. Contains a Docker deployment of Django, Celery, and Redis.
+- Parameters:
+  - `MINIO_ACCESS_KEY`
+  - `MINIO_SECRET_KEY`
+  - `MINIO_ENDPOINT`
+
+## Running the Setup Script
+To run the setup script:
+1. Clone this repository to your local machine.
+2. Navigate to the root directory of the project.
+3. Run the following command: `python deploy.py`
+
+
+## What the script does?
+- Automatically creates a Docker network named `shoonya_backend`.
+- Prompts the user to choose whether to run the application in production mode.
+- Guides the user through setting up a PostgreSQL container if desired.
+- Allows selection of components and sets up Docker Compose files accordingly.
+- Manages environment variables in the `.env` file for each selected component.
+- Deploys Docker containers for selected components.
+- Provides feedback and error handling throughout the setup process.
+
+
+
+
diff --git a/deploy.py b/deploy.py
index 5289863f8..c87fa70bc 100644
--- a/deploy.py
+++ b/deploy.py
@@ -27,6 +27,16 @@
                 "default": "db",
                 "warning": "Please provide a valid database host",
             },
+            "REDIS_HOST": {
+                "help": "If you are using the inbuilt redis as broker, leave these to default",
+                "default": "redis",
+                "warning": "Please provide a valid redis host",
+            },
+            "REDIS_PORT": {
+                "help": "If you are using the inbuilt redis as broker, leave these to default",
+                "default": "6379",
+                "warning": "Please provide a valid redis port",
+            },
             "CELERY_BROKER_URL": {
                 "help": "Broker for celery tasks",
                 "default": "redis://redis:6379/0",
@@ -37,16 +47,6 @@
                 "default": "abcd1234",
                 "warning": "Please provide a valid secret key",
             },
-            "AZURE_CONNECTION_STRING": {
-                "help": "AZURE storage string",
-                "default": "AZURE_CONNECTION_STRING=DefaultEndpointsProtocol=https;AccountName=dummydeveloper;AccountKey=hello/Jm+uq4gvGgd5aloGrqVxYnRs/dgPHX0G6U4XmLCtZCIeKyNNK0n3Q9oRDNE+AStMDbqXg==;EndpointSuffix=core.windows.net",
-                "warning": "Please provide a valid Azure connection string",
-            },
-            "LOGS_CONTAINER_NAME": {
-                "help": "Logs container name",
-                "default": "logs",
-                "warning": "Please provide a valid logs container name",
-            },
         },
     },
     "Nginx_Certbot": {
@@ -268,6 +268,16 @@
         "default": "dev",
         "help": "The environment in which the application is running. PROD : Production, DEV : Development",
     },
+    "AZURE_CONNECTION_STRING": {
+        "help": "AZURE storage string",
+        "default": "AZURE_CONNECTION_STRING=DefaultEndpointsProtocol=https;AccountName=dummydeveloper;AccountKey=hello/Jm+uq4gvGgd5aloGrqVxYnRs/dgPHX0G6U4XmLCtZCIeKyNNK0n3Q9oRDNE+AStMDbqXg==;EndpointSuffix=core.windows.net",
+        
+    },
+    "LOGS_CONTAINER_NAME": {
+        "help": "Logs container name",
+        "default": "logs",
+        
+    },
 }
 
 

From e6122394b40199eefbb0e116dcc60852e162146c Mon Sep 17 00:00:00 2001
From: Pursottam6003 <rahulsah6003@gmail.com>
Date: Wed, 17 Apr 2024 23:34:23 +0530
Subject: [PATCH 09/16] updated the readme file for better code understanding

---
 NewReadme.md | 182 ++++++++++++++++++++++++++++++++++++++++++---------
 deploy.py    |   4 +-
 2 files changed, 153 insertions(+), 33 deletions(-)

diff --git a/NewReadme.md b/NewReadme.md
index d1c0c5ce7..5a54325ec 100644
--- a/NewReadme.md
+++ b/NewReadme.md
@@ -10,12 +10,56 @@ The project was created using [Python 3.7](https://www.python.org/downloads/). A
 
 
 
+<details>
+  <summary><i>Wow, so fancy</i></summary>
+  <b>WOW, SO BOLD</b>
+</details>
+
 # Project Name README
 
 ## Prerequisites
-- Docker Engine/Docker Desktop running
+- **Docker Engine/Docker Desktop running** 
+    You may download Docker Desktop from the table given below 
+        
+  | Systems| Link |
+  | ---------- | ------ |
+  | Windows | https://docs.docker.com/desktop/install/windows-install/ |
+  | Ubuntu | https://docs.docker.com/desktop/install/ubuntu/ |
+  | Unix/Mac | https://docs.docker.com/desktop/install/mac-install/|
+- Python Version 3.7 or above 
+- An Azure account subscription.
+
+## Backend Setup 
+The whole backend setup is divided into mainly 5 Components 
+```
+Backend Setup
+|
+|-- 1. Database Setup
+|
+|-- 2. Default Components
+|   |-- a) Django
+|   |-- b) Celery
+|   |-- c) Redis
+|
+|-- 3. Elastic Logstash Kibana (ELK) & Flower Confirguration
+|
+|-- 4. Nginx-Certbot 
+|
+|-- 5. Additional Services
+|   |-- a) Google Application Credentials
+|   |-- b) Ask_Dhruva
+|   |-- c) Indic_Trans_V2
+|   |-- d) Email Service
+|   |-- e) Logging
+|   |-- f) Minio
+```
+
+
+<details> 
+<summary style="font-size:larger; font-weight:bold"> 
+  1. Database Setup
+</summary>
 
-## Database Setup
 To set up a PostgreSQL container:
 - When prompted during the script execution, enter 'Y' to include PostgreSQL installation.
 - Alternatively, manually provide the following database variables in the `.env` file:
@@ -23,25 +67,51 @@ To set up a PostgreSQL container:
   - `DB_USER`
   - `DB_PASSWORD`
   - `DB_HOST`
+</details>
+
 
-## Default Components
-This section includes the default setup required for the application to work. It contains Docker deployments of Django, Celery, and Redis.
+<details> 
+<summary style="font-size:larger; font-weight:bold"> 
+  2. Default Components
+</summary>
 
-### Django
-- Description: Django is a high-level Python web framework.
+This section outlines the essential setup needed for the application to function properly. It encompasses Docker deployments for Django, Celery, and Redis, which form the core components of our application infrastructure.
+
+#### a) Django
+- **Description:** Django is a Python-based framework for web development, providing tools and features to build robust web applications quickly and efficiently.
 - Configuration:
-  - `SECRET_KEY`: Django secret key
+  - `SECRET_KEY`: Django secret key either enter manually or generate using the command 
+
+  To create a new secret key, run the following commands (within the virtual environment):
+  ```
+  # Open a Python shell
+  python backend/manage.py shell
 
-### Celery
-- Description: Celery is an asynchronous task queue/job queue based on distributed message passing.
+  >> from django.core.management.utils import get_random_secret_key
+  >> get_random_secret_key()
+  ```
+
+#### b) Celery
+- **Description:** Celery is a system for asynchronous task processing based on distributed message passing, allowing computationally intensive operations to run in the background without impacting the main application's performance.
 - Configuration:
   - `CELERY_BROKER_URL`: Broker for Celery tasks
+  
 
-### Redis
+#### c) Redis
 - Description: Redis is an open-source, in-memory data structure store used as a database, cache, and message broker.
-- Configuration: None
+- Configuration: 
+  - `REDIS_HOST`: Need to configue the port
+  - `REDIS_PORT` : Need to configure the port
+
+</details>
+
+<details> 
+<summary style="font-size:larger; font-weight:bold"> 
+  3. ELK & Flower configuration
+</summary>
 
-## Elasticsearch-Logstash-Kibana
+
+#### a) Elasticsearch-Logstash-Kibanas
 This section contains the ELK stack for logging monitoring etc.
 
 - Elasticsearch
@@ -58,7 +128,29 @@ This section contains the ELK stack for logging monitoring etc.
   - Description: Kibana is an open-source data visualization dashboard for Elasticsearch.
   - Configuration: None
 
-## Nginx-Certbot
+
+
+#### b) Flower Confirguation
+- Flower is a web-based tool for     monitoring and  administrating Celery clusters. It allows you to keep track of tasks as they flow through your system, inspect the 
+system's health, and perform administrative operations 
+like shutting down workers. 
+
+- Additionally, Flower would be monitoring the 
+tasks defined in our tasks/ directory in 
+the `backend/directory`. 
+
+- Configuration:
+    - `FLOWER_USERNAME`: Flower username
+    - `FLOWER_PASSWORD`: Flower password 
+    - `FLOWER_PORT`: Need to configure 
+
+</details>
+
+<details> 
+<summary style="font-size:larger; font-weight:bold"> 
+  4. Nginx-Certbot
+</summary>
+
 This section contains Nginx and Certbot setup for serving HTTPS traffic.
 
 - Nginx
@@ -69,10 +161,19 @@ This section contains Nginx and Certbot setup for serving HTTPS traffic.
   - Description: Certbot is a free, open-source software tool for automatically using Let's Encrypt certificates on manually-administrated websites to enable HTTPS.
   - Configuration: None
 
-## Additional Services
+</details>
+
+
+<details> 
+<summary style="font-size:larger; font-weight:bold"> 
+  5 Additional Services
+</summary>
 
-### Google Application Credentials
-- Description: Google Application Credentials for accessing Google APIs.
+
+These are the additional services that were not only present in certain confirguration but its actually present in whole files some of them  are global variables and some are services. 
+
+#### a) Google Application Credentials
+- **Description**: Google Application Credentials are used to authenticate and authorize applications to use Google Cloud APIs. They are a key part of Google Cloud's IAM (Identity and Access Management) system, and they allow the application to interact with Google's services securely.
 - Parameters:
   - `type`
   - `project_id`
@@ -86,44 +187,63 @@ This section contains Nginx and Certbot setup for serving HTTPS traffic.
   - `client_x509_cert_url`
   - `universe_domain`
 
-### Ask_Dhruva
-- Description: Component for interacting with Dhruva ASR service.
+#### b) Ask_Dhruva
+- Description: Component for interacting with Dhruva ASR service.  This service is likely used in your application to convert spoken language into written text.
 - Parameters:
-  - `ASR_DHRUVA_URL`: URL for Dhruva ASR service
-  - `ASR_DHRUVA_AUTHORIZATION`: Authorization token for Dhruva ASR service
+  - `ASR_DHRUVA_URL`:  Parameter is used to tell your application where to send requests for speech recognition.
+  - `ASR_DHRUVA_AUTHORIZATION`: Authorization token for Dhruva ASR service. 
 
-### Indic_Trans_V2
+#### c) Indic_Trans_V2
 - Description: Component for interacting with Indic Trans V2 service.
 - Parameters:
   - `INDIC_TRANS_V2_KEY`: API key for Indic Trans V2 service
   - `INDIC_TRANS_V2_URL`: URL for Indic Trans V2 service
 
-### Email Service
-- Description: Required for the application to work. Contains a Docker deployment of Django, Celery, and Redis.
+#### d) Email Service
+- **Description**: The Email Service is likely used in your application to send emails. This could be for a variety of purposes such as sending notifications, password resets, confirmation emails, sending reports etc.
 - Parameters:
   - `EMAIL_HOST`
   - `SMTP_USERNAME`
   - `SMTP_PASSWORD`
   - `DEFAULT_FROM_EMAIL`
 
-### Logging
-- Description: Required for the application to work. Contains a Docker deployment of Django, Celery, and Redis.
-- Parameters:
-  - `LOGGING`
-  - `LOG_LEVEL`
+#### e) Logging
+- Description:
+Logging  is used to record events or actions that occur during the execution of your program. It's a crucial part of software development for debugging and monitoring purposes
 
-### MINIO
-- Description: Required for the application to work. Contains a Docker deployment of Django, Celery, and Redis.
+- Required for the application to work. Contains a Docker deployment of Django, Celery, and Redis.
+- Parameters:
+  - `LOGGING` :  This is a boolean value (either 'true' or 
+'false') that determines whether logging is enabled. 
+  - `LOG_LEVEL` :  This sets the level of logging. 'INFO' will 
+log all INFO, WARNING, ERROR, and CRITICAL level 
+logs. 
+
+#### f) MINIO
+- Description: MinIO is an open-source, high-performance, AWS S3 compatible object storage system. It is typically used in applications for storing unstructured data like photos, videos, log files, backups, and container/VM images.
 - Parameters:
   - `MINIO_ACCESS_KEY`
   - `MINIO_SECRET_KEY`
   - `MINIO_ENDPOINT`
 
+</details>
+
 ## Running the Setup Script
+
 To run the setup script:
 1. Clone this repository to your local machine.
+
+```bash
+git clone "https://github.com/AI4Bharat/Shoonya-Backend"
+```
 2. Navigate to the root directory of the project.
-3. Run the following command: `python deploy.py`
+```bash 
+cd Shoonya_Backend
+```
+3. Run the following command: `python deploy.py` make sure the docker engine is running on your system
+4. Provide the details that has been asking in the prompt and it will automatically create & run  the docker containers, volumnes and processes 
+
+
 
 
 ## What the script does?
diff --git a/deploy.py b/deploy.py
index c87fa70bc..a1886eb1c 100644
--- a/deploy.py
+++ b/deploy.py
@@ -332,7 +332,7 @@ def run_application():
                 check=True,
             )
 
-        for key, value in mapping.items():
+        for key, value in component_mapping.items():
             choice = click.prompt(
                 f"Do you want to include {key}? ({value['description']}) (Y/N)",
                 default="N",
@@ -364,7 +364,7 @@ def run_application():
             with open("backend/.env", "w") as env_file:
                 for component, params in parameters_dict.items():
                     for param, value in params.items():
-                        env_file.write(f"{param}={value}\n")
+                        env_file.write(f"{param}='{value}'\n")
 
         if docker_compose_files:
             click.echo("Running Docker Compose...")

From 7732bf8be14ba11a22ff6f4893de5ddb2cf91acd Mon Sep 17 00:00:00 2001
From: Amarendra Shendkar <amarshendkar.as@gmail.com>
Date: Wed, 1 May 2024 11:47:56 +0530
Subject: [PATCH 10/16] minor change

---
 default_script.py | 0
 deploy.py         | 2 +-
 2 files changed, 1 insertion(+), 1 deletion(-)
 create mode 100644 default_script.py

diff --git a/default_script.py b/default_script.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/deploy.py b/deploy.py
index c87fa70bc..60e0f3374 100644
--- a/deploy.py
+++ b/deploy.py
@@ -264,7 +264,7 @@
 }
 
 environment = {
-    "ENVIRONMENT": {
+    "ENV": {
         "default": "dev",
         "help": "The environment in which the application is running. PROD : Production, DEV : Development",
     },

From 9f3b1047fd9b2bead49d0df86a369aaf758f0eef Mon Sep 17 00:00:00 2001
From: Amarendra Shendkar <amarshendkar.as@gmail.com>
Date: Wed, 1 May 2024 12:25:16 +0530
Subject: [PATCH 11/16] added script for defaul setup

---
 default-setup.py             | 51 ++++++++++++++++++++++++++++++++++++
 default_script.py            |  0
 deploy.py => docker-setup.py |  0
 elk-docker-compose.yml       |  6 ++---
 4 files changed, 53 insertions(+), 4 deletions(-)
 create mode 100644 default-setup.py
 delete mode 100644 default_script.py
 rename deploy.py => docker-setup.py (100%)

diff --git a/default-setup.py b/default-setup.py
new file mode 100644
index 000000000..17a93e53e
--- /dev/null
+++ b/default-setup.py
@@ -0,0 +1,51 @@
+import os
+import subprocess
+import sys
+
+def setup_repository():
+    # Clone the repository
+    subprocess.run(["git", "clone", "https://github.com/AI4Bharat/Shoonya-Backend.git"])
+    os.chdir("Shoonya-Backend")
+    # Switch to the development branch
+    subprocess.run(["git", "checkout", "dev"])
+    subprocess.run(["git", "pull", "origin", "dev"])
+
+def install_dependencies():
+    # Create a virtual environment
+    subprocess.run(["python3", "-m", "venv", "venv"])
+    # Activate the virtual environment
+    if sys.platform == "win32":
+        activate_script = "venv\\Scripts\\activate"
+    else:
+        activate_script = "venv/bin/activate"
+    subprocess.run(["source", activate_script])
+    # Install dependencies
+    subprocess.run(["pip", "install", "-r", "./backend/deploy/requirements.txt"])
+
+def setup_env_file():
+    # Copy .env.example to .env
+    subprocess.run(["cp", ".env.example", "./backend/.env"])
+    # Generate a new secret key
+    new_secret_key = subprocess.run(["python", "-c", "from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())"], capture_output=True, text=True)
+    new_secret_key = new_secret_key.stdout.strip()
+    # Update .env with the new secret key
+    with open("./backend/.env", "a") as env_file:
+        env_file.write(f"\nSECRET_KEY='{new_secret_key}'\n")
+    print("New secret key has been generated and updated in .env")
+
+def run_celery_instances():
+    # Start Redis server
+    print("Please ensure Redis is installed and running on port 6379.")
+    # Start Celery workers
+    subprocess.run(["celery", "-A", "shoonya_backend.celery", "worker", "--concurrency=2", "--loglevel=info"])
+    # Start Celery beat
+    subprocess.run(["celery", "-A", "shoonya_backend.celery", "beat", "--loglevel=info"])
+
+def main():
+    setup_repository()
+    install_dependencies()
+    setup_env_file()
+    run_celery_instances()
+
+if __name__ == "__main__":
+    main()
diff --git a/default_script.py b/default_script.py
deleted file mode 100644
index e69de29bb..000000000
diff --git a/deploy.py b/docker-setup.py
similarity index 100%
rename from deploy.py
rename to docker-setup.py
diff --git a/elk-docker-compose.yml b/elk-docker-compose.yml
index f04d31199..68bb52fcf 100644
--- a/elk-docker-compose.yml
+++ b/elk-docker-compose.yml
@@ -6,7 +6,7 @@ services:
     image: docker.elastic.co/elasticsearch/elasticsearch:7.14.0
     volumes:
       - ./elasticsearch/elasticsearch.yml:/usr/share/elasticsearch/config/elasticsearch.yml
-      # - elasticsearch_vol:/elasticsearch_data
+      - elasticsearch_vol:/elasticsearch_data
     environment:
       - discovery.type=single-node
     ports:
@@ -27,16 +27,14 @@ services:
     hostname: shoonya_dev_logger
     volumes:
       - ./logstash_dev.conf:/usr/share/logstash/pipeline/logstash.conf
-      # - logs_vol:/logs
+      - logs_vol:/logs
     extra_hosts:
       - "elasticsearch:elasticsearch"
     command: logstash -f /usr/share/logstash/pipeline/logstash.conf
 
 volumes:
   elasticsearch_vol:
-    external: true
   logs_vol:
-    external: true
 
 networks:
   shoonya_backend:

From 169d9a6863d7b8d71dbf16b5ee140ac9044316b4 Mon Sep 17 00:00:00 2001
From: Amarendra Shendkar <amarshendkar.as@gmail.com>
Date: Wed, 1 May 2024 12:25:48 +0530
Subject: [PATCH 12/16] setup redis as part of default setup

---
 default-setup.py | 17 ++++++-----------
 1 file changed, 6 insertions(+), 11 deletions(-)

diff --git a/default-setup.py b/default-setup.py
index 17a93e53e..407a05047 100644
--- a/default-setup.py
+++ b/default-setup.py
@@ -2,14 +2,6 @@
 import subprocess
 import sys
 
-def setup_repository():
-    # Clone the repository
-    subprocess.run(["git", "clone", "https://github.com/AI4Bharat/Shoonya-Backend.git"])
-    os.chdir("Shoonya-Backend")
-    # Switch to the development branch
-    subprocess.run(["git", "checkout", "dev"])
-    subprocess.run(["git", "pull", "origin", "dev"])
-
 def install_dependencies():
     # Create a virtual environment
     subprocess.run(["python3", "-m", "venv", "venv"])
@@ -33,18 +25,21 @@ def setup_env_file():
         env_file.write(f"\nSECRET_KEY='{new_secret_key}'\n")
     print("New secret key has been generated and updated in .env")
 
-def run_celery_instances():
+def start_redis():
     # Start Redis server
-    print("Please ensure Redis is installed and running on port 6379.")
+    print("Starting Redis server...")
+    subprocess.run(["redis-server"])
+
+def run_celery_instances():
     # Start Celery workers
     subprocess.run(["celery", "-A", "shoonya_backend.celery", "worker", "--concurrency=2", "--loglevel=info"])
     # Start Celery beat
     subprocess.run(["celery", "-A", "shoonya_backend.celery", "beat", "--loglevel=info"])
 
 def main():
-    setup_repository()
     install_dependencies()
     setup_env_file()
+    start_redis()
     run_celery_instances()
 
 if __name__ == "__main__":

From 0e78e0ad83d5e5c50ca2364766f934de617ed239 Mon Sep 17 00:00:00 2001
From: Amarendra Shendkar <amarshendkar.as@gmail.com>
Date: Fri, 3 May 2024 12:15:12 +0530
Subject: [PATCH 13/16] fixed script

---
 default-setup.py | 91 +++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 78 insertions(+), 13 deletions(-)

diff --git a/default-setup.py b/default-setup.py
index 407a05047..f9a60379b 100644
--- a/default-setup.py
+++ b/default-setup.py
@@ -1,46 +1,111 @@
 import os
 import subprocess
 import sys
+import time
+import shutil
+import string
+import random
+def generate_secret_key(length=50):
+    """
+    Generate a random Django secret key.
+    """
+    characters = string.ascii_letters + string.digits + "!@#$%^&*(-_=+)"
+    return ''.join(random.choice(characters) for _ in range(length))
 
 def install_dependencies():
     # Create a virtual environment
     subprocess.run(["python3", "-m", "venv", "venv"])
     # Activate the virtual environment
     if sys.platform == "win32":
-        activate_script = "venv\\Scripts\\activate"
+        activate_script = os.path.join("venv", "Scripts", "activate.bat")
     else:
-        activate_script = "venv/bin/activate"
-    subprocess.run(["source", activate_script])
+        activate_script = os.path.join("venv", "bin", "activate")
+    subprocess.run([activate_script])
+
     # Install dependencies
     subprocess.run(["pip", "install", "-r", "./backend/deploy/requirements.txt"])
 
+
 def setup_env_file():
     # Copy .env.example to .env
-    subprocess.run(["cp", ".env.example", "./backend/.env"])
+    shutil.copy(".env.example", "./backend/.env")
+   
+
     # Generate a new secret key
-    new_secret_key = subprocess.run(["python", "-c", "from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())"], capture_output=True, text=True)
-    new_secret_key = new_secret_key.stdout.strip()
+    new_secret_key = generate_secret_key()
     # Update .env with the new secret key
     with open("./backend/.env", "a") as env_file:
         env_file.write(f"\nSECRET_KEY='{new_secret_key}'\n")
     print("New secret key has been generated and updated in .env")
 
-def start_redis():
-    # Start Redis server
-    print("Starting Redis server...")
-    subprocess.run(["redis-server"])
 
 def run_celery_instances():
+
+    # Activate the virtual environment
+    if sys.platform == "win32":
+        activate_script = os.path.join("venv", "Scripts", "activate.bat")
+    else:
+        activate_script = os.path.join("venv", "bin", "activate")
+    subprocess.run([activate_script])
+
+
+    
+    os.chdir("backend")
+    
     # Start Celery workers
-    subprocess.run(["celery", "-A", "shoonya_backend.celery", "worker", "--concurrency=2", "--loglevel=info"])
+    celery_worker_process = subprocess.Popen(
+        [
+            "celery",
+            "-A",
+            "shoonya_backend.celery",
+            "worker",
+            "--concurrency=2",
+            "--loglevel=info",
+        ],
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+    )
     # Start Celery beat
-    subprocess.run(["celery", "-A", "shoonya_backend.celery", "beat", "--loglevel=info"])
+    celery_beat_process = subprocess.Popen(
+        ["celery", "-A", "shoonya_backend.celery", "beat", "--loglevel=info"],
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+    )
+
+    # Capture and print the output
+    worker_output, worker_errors = celery_worker_process.communicate()
+    beat_output, beat_errors = celery_beat_process.communicate()
+
+    print("Celery Worker Output:")
+    print(worker_output.decode("utf-8"))
+    print("Celery Worker Errors:")
+    print(worker_errors.decode("utf-8"))
+
+    print("Celery Beat Output:")
+    print(beat_output.decode("utf-8"))
+    print("Celery Beat Errors:")
+    print(beat_errors.decode("utf-8"))
+
+
+def start_django_server():
+    # Activate the virtual environment
+    if sys.platform == "win32":
+        activate_script = os.path.join("venv", "Scripts", "activate.bat")
+    else:
+        activate_script = os.path.join("venv", "bin", "activate")
+    subprocess.run([activate_script])
+
+    # Start Django server
+    print("Starting Django server...")
+    subprocess.Popen(["python", "./backend/manage.py", "runserver"])
+
 
 def main():
     install_dependencies()
     setup_env_file()
-    start_redis()
     run_celery_instances()
+    start_django_server()
+
 
 if __name__ == "__main__":
     main()

From 04c7577fc3e6ab6060d25b5ca99d43282931f281 Mon Sep 17 00:00:00 2001
From: Pursottam6003 <rahulsah6003@gmail.com>
Date: Sun, 5 May 2024 01:39:37 +0530
Subject: [PATCH 14/16] updated the readme file of documentation

---
 NewReadme.md       | 260 ----------------------------
 README.md          | 421 ++++++++++++++++++++++++++++++++++++---------
 oldReadme.md       | 226 ++++++++++++++++++++++++
 public/image-2.png | Bin 0 -> 54688 bytes
 public/image.png   | Bin 0 -> 51199 bytes
 5 files changed, 562 insertions(+), 345 deletions(-)
 delete mode 100644 NewReadme.md
 create mode 100644 oldReadme.md
 create mode 100644 public/image-2.png
 create mode 100644 public/image.png

diff --git a/NewReadme.md b/NewReadme.md
deleted file mode 100644
index 5a54325ec..000000000
--- a/NewReadme.md
+++ /dev/null
@@ -1,260 +0,0 @@
-# Shoonya Backend
-
-Repository for Shoonya's backend.
-
-## Pre-requisites
-
-The project was created using [Python 3.7](https://www.python.org/downloads/). All major dependencies along with the versions are listed in the `backend/deploy/requirements.txt` file.
-
-## Installation
-
-
-
-<details>
-  <summary><i>Wow, so fancy</i></summary>
-  <b>WOW, SO BOLD</b>
-</details>
-
-# Project Name README
-
-## Prerequisites
-- **Docker Engine/Docker Desktop running** 
-    You may download Docker Desktop from the table given below 
-        
-  | Systems| Link |
-  | ---------- | ------ |
-  | Windows | https://docs.docker.com/desktop/install/windows-install/ |
-  | Ubuntu | https://docs.docker.com/desktop/install/ubuntu/ |
-  | Unix/Mac | https://docs.docker.com/desktop/install/mac-install/|
-- Python Version 3.7 or above 
-- An Azure account subscription.
-
-## Backend Setup 
-The whole backend setup is divided into mainly 5 Components 
-```
-Backend Setup
-|
-|-- 1. Database Setup
-|
-|-- 2. Default Components
-|   |-- a) Django
-|   |-- b) Celery
-|   |-- c) Redis
-|
-|-- 3. Elastic Logstash Kibana (ELK) & Flower Confirguration
-|
-|-- 4. Nginx-Certbot 
-|
-|-- 5. Additional Services
-|   |-- a) Google Application Credentials
-|   |-- b) Ask_Dhruva
-|   |-- c) Indic_Trans_V2
-|   |-- d) Email Service
-|   |-- e) Logging
-|   |-- f) Minio
-```
-
-
-<details> 
-<summary style="font-size:larger; font-weight:bold"> 
-  1. Database Setup
-</summary>
-
-To set up a PostgreSQL container:
-- When prompted during the script execution, enter 'Y' to include PostgreSQL installation.
-- Alternatively, manually provide the following database variables in the `.env` file:
-  - `DB_NAME`
-  - `DB_USER`
-  - `DB_PASSWORD`
-  - `DB_HOST`
-</details>
-
-
-<details> 
-<summary style="font-size:larger; font-weight:bold"> 
-  2. Default Components
-</summary>
-
-This section outlines the essential setup needed for the application to function properly. It encompasses Docker deployments for Django, Celery, and Redis, which form the core components of our application infrastructure.
-
-#### a) Django
-- **Description:** Django is a Python-based framework for web development, providing tools and features to build robust web applications quickly and efficiently.
-- Configuration:
-  - `SECRET_KEY`: Django secret key either enter manually or generate using the command 
-
-  To create a new secret key, run the following commands (within the virtual environment):
-  ```
-  # Open a Python shell
-  python backend/manage.py shell
-
-  >> from django.core.management.utils import get_random_secret_key
-  >> get_random_secret_key()
-  ```
-
-#### b) Celery
-- **Description:** Celery is a system for asynchronous task processing based on distributed message passing, allowing computationally intensive operations to run in the background without impacting the main application's performance.
-- Configuration:
-  - `CELERY_BROKER_URL`: Broker for Celery tasks
-  
-
-#### c) Redis
-- Description: Redis is an open-source, in-memory data structure store used as a database, cache, and message broker.
-- Configuration: 
-  - `REDIS_HOST`: Need to configue the port
-  - `REDIS_PORT` : Need to configure the port
-
-</details>
-
-<details> 
-<summary style="font-size:larger; font-weight:bold"> 
-  3. ELK & Flower configuration
-</summary>
-
-
-#### a) Elasticsearch-Logstash-Kibanas
-This section contains the ELK stack for logging monitoring etc.
-
-- Elasticsearch
-  - Description: Elasticsearch is a distributed, RESTful search and analytics engine.
-  - Configuration:
-    - `ELASTICSEARCH_URL`: URL for Elasticsearch
-    - `INDEX_NAME`: Index name
-
-- Logstash
-  - Description: Logstash is a server-side data processing pipeline that ingests data from multiple sources simultaneously, transforms it, and then sends it to a "stash" like Elasticsearch.
-  - Configuration: None
-
-- Kibana
-  - Description: Kibana is an open-source data visualization dashboard for Elasticsearch.
-  - Configuration: None
-
-
-
-#### b) Flower Confirguation
-- Flower is a web-based tool for     monitoring and  administrating Celery clusters. It allows you to keep track of tasks as they flow through your system, inspect the 
-system's health, and perform administrative operations 
-like shutting down workers. 
-
-- Additionally, Flower would be monitoring the 
-tasks defined in our tasks/ directory in 
-the `backend/directory`. 
-
-- Configuration:
-    - `FLOWER_USERNAME`: Flower username
-    - `FLOWER_PASSWORD`: Flower password 
-    - `FLOWER_PORT`: Need to configure 
-
-</details>
-
-<details> 
-<summary style="font-size:larger; font-weight:bold"> 
-  4. Nginx-Certbot
-</summary>
-
-This section contains Nginx and Certbot setup for serving HTTPS traffic.
-
-- Nginx
-  - Description: Nginx is a web server that can also be used as a reverse proxy, load balancer, mail proxy, and HTTP cache.
-  - Configuration: None
-
-- Certbot
-  - Description: Certbot is a free, open-source software tool for automatically using Let's Encrypt certificates on manually-administrated websites to enable HTTPS.
-  - Configuration: None
-
-</details>
-
-
-<details> 
-<summary style="font-size:larger; font-weight:bold"> 
-  5 Additional Services
-</summary>
-
-
-These are the additional services that were not only present in certain confirguration but its actually present in whole files some of them  are global variables and some are services. 
-
-#### a) Google Application Credentials
-- **Description**: Google Application Credentials are used to authenticate and authorize applications to use Google Cloud APIs. They are a key part of Google Cloud's IAM (Identity and Access Management) system, and they allow the application to interact with Google's services securely.
-- Parameters:
-  - `type`
-  - `project_id`
-  - `private_key_id`
-  - `private_key`
-  - `client_email`
-  - `client_id`
-  - `auth_uri`
-  - `token_uri`
-  - `auth_provider_x509_cert_url`
-  - `client_x509_cert_url`
-  - `universe_domain`
-
-#### b) Ask_Dhruva
-- Description: Component for interacting with Dhruva ASR service.  This service is likely used in your application to convert spoken language into written text.
-- Parameters:
-  - `ASR_DHRUVA_URL`:  Parameter is used to tell your application where to send requests for speech recognition.
-  - `ASR_DHRUVA_AUTHORIZATION`: Authorization token for Dhruva ASR service. 
-
-#### c) Indic_Trans_V2
-- Description: Component for interacting with Indic Trans V2 service.
-- Parameters:
-  - `INDIC_TRANS_V2_KEY`: API key for Indic Trans V2 service
-  - `INDIC_TRANS_V2_URL`: URL for Indic Trans V2 service
-
-#### d) Email Service
-- **Description**: The Email Service is likely used in your application to send emails. This could be for a variety of purposes such as sending notifications, password resets, confirmation emails, sending reports etc.
-- Parameters:
-  - `EMAIL_HOST`
-  - `SMTP_USERNAME`
-  - `SMTP_PASSWORD`
-  - `DEFAULT_FROM_EMAIL`
-
-#### e) Logging
-- Description:
-Logging  is used to record events or actions that occur during the execution of your program. It's a crucial part of software development for debugging and monitoring purposes
-
-- Required for the application to work. Contains a Docker deployment of Django, Celery, and Redis.
-- Parameters:
-  - `LOGGING` :  This is a boolean value (either 'true' or 
-'false') that determines whether logging is enabled. 
-  - `LOG_LEVEL` :  This sets the level of logging. 'INFO' will 
-log all INFO, WARNING, ERROR, and CRITICAL level 
-logs. 
-
-#### f) MINIO
-- Description: MinIO is an open-source, high-performance, AWS S3 compatible object storage system. It is typically used in applications for storing unstructured data like photos, videos, log files, backups, and container/VM images.
-- Parameters:
-  - `MINIO_ACCESS_KEY`
-  - `MINIO_SECRET_KEY`
-  - `MINIO_ENDPOINT`
-
-</details>
-
-## Running the Setup Script
-
-To run the setup script:
-1. Clone this repository to your local machine.
-
-```bash
-git clone "https://github.com/AI4Bharat/Shoonya-Backend"
-```
-2. Navigate to the root directory of the project.
-```bash 
-cd Shoonya_Backend
-```
-3. Run the following command: `python deploy.py` make sure the docker engine is running on your system
-4. Provide the details that has been asking in the prompt and it will automatically create & run  the docker containers, volumnes and processes 
-
-
-
-
-## What the script does?
-- Automatically creates a Docker network named `shoonya_backend`.
-- Prompts the user to choose whether to run the application in production mode.
-- Guides the user through setting up a PostgreSQL container if desired.
-- Allows selection of components and sets up Docker Compose files accordingly.
-- Manages environment variables in the `.env` file for each selected component.
-- Deploys Docker containers for selected components.
-- Provides feedback and error handling throughout the setup process.
-
-
-
-
diff --git a/README.md b/README.md
index 5281a3da1..c555e5553 100644
--- a/README.md
+++ b/README.md
@@ -6,138 +6,389 @@ Repository for Shoonya's backend.
 
 The project was created using [Python 3.7](https://www.python.org/downloads/). All major dependencies along with the versions are listed in the `backend/deploy/requirements.txt` file.
 
-## Installation
+## Setup and Installation
 
-The installation and setup instructions have been tested on the following platforms:
+Please follow the below instructions for setup and installation. These steps have been verified on the following operating systems:
 
-It can be done in 2 ways:-
-1) using docker by running all services in containers or
-2) directly running the services on local one by one (like, celery and redis).
-   
-If your preference is 1 over 2 please be fixed to this environment and follow the steps below it:
 
-- Docker
-- Ubuntu 20.04 OR macOs 
+| Systems   | Requirements |
+| --------- | ------------ |
+| Windows   | Windows 10 or later with at least 8GB of RAM. |
+| Ubuntu    | Ubuntu 20.04 or later with at least 4GB of RAM.  |
+| Unix/Mac  | macOS 10.13 or later with at least 4GB of RAM. |
 
-If you are using a different operating system, you will have to look at external resources (eg. StackOverflow) to correct any errors.
+
+The installation can be done in three ways, each with its own advantages:
+
+1. **Instruction-based prompt Interaction**: This is the latest, easiest, and most hassle-free installation method. All services will be run under Docker containers and volumes, ensuring a consistent environment and simplifying the setup process.
+
+2. **Using Docker by running all services in containers**: This method also uses Docker, but requires running a single compose file. While this method is also straightforward, it might throw errors if the compose file is not correctly configured or if there are issues with the Docker setup.
+
+3. **Traditional deployment using Django manage.py runserver default script**: This method involves running the services locally one by one (like Celery and Redis). While this method gives you the most control and visibility into each service, it is more complex and time-consuming. Also, asynchronous tasks won't work under Celery tasks in this setup.
+
+## Prerequisites
 
 ### Create a Virtual Environment
 
 We recommend you to create a virtual environment to install all the dependencies required for the project.
 
+For **Ubuntu/Mac**:
+
 ```bash
 python3 -m venv <YOUR-ENVIRONMENT-NAME>
-source <YOUR-ENVIRONMENT-NAME>/bin/activate # this command may be different based on your OS
-
-# Install dependencies
-pip install -r deploy/requirements-dev.txt
+source <YOUR-ENVIRONMENT-NAME>/bin/activate
+```
+For **Windows**:
+```bash
+python -m venv <YOUR-ENVIRONMENT-NAME>
+<YOUR-ENVIRONMENT-NAME>\Scripts\activate
 ```
 
-### Environment file
+If you are choosing 1st or 2nd method then you need to install Docker on your system
+
+- **Docker Engine/Docker Desktop running** 
+    You may download Docker Desktop from the table given below 
+        
+  | Systems| Link |
+  | ---------- | ------ |
+  | Windows | https://docs.docker.com/desktop/install/windows-install/ |
+  | Ubuntu | https://docs.docker.com/desktop/install/ubuntu/ |
+  | Unix/Mac | https://docs.docker.com/desktop/install/mac-install/|
+- Python Version 3.7 or above 
+- An Azure account subscription.
+
+## Running the Setup Script
+
+To run the setup script:
+1. Clone this repository to your local machine.
 
-To set up the environment variables needed for the project, run the following lines:
 ```bash
-cp .env.example ./backend/.env
+git clone "https://github.com/AI4Bharat/Shoonya-Backend"
+```
+2. Navigate to the root directory of the project.
+```bash 
+cd Shoonya-Backend
+pip install -r ./backend/deploy/requirements.txt
 ```
 
-This creates an `.env` file at the root of the project. It is needed to make sure that the project runs correctly. Please go through the file and set the parameters according to your installation.
+Now choosing the best option for  Installation method (mentioned above) It is important to know brief about them 
 
-To create a new secret key, run the following commands (within the virtual environment):
-```bash
-# Open a Python shell
-python backend/manage.py shell
+> Note : You may skip this section if you are already familiar with the concepts, but reviewing it could enhance your understanding of the backend setup.
 
->> from django.core.management.utils import get_random_secret_key
->> get_random_secret_key()
+## Backend Components 
+The whole backend setup is divided into mainly 5 Components 
+```
+Backend Setup
+|
+|-- 1. Database Setup
+|
+|-- 2. Default Components
+|   |-- a) Django
+|   |-- b) Celery
+|   |-- c) Redis
+|
+|-- 3. Elastic Logstash Kibana (ELK) & Flower Confirguration
+|
+|-- 4. Nginx-Certbot 
+|
+|-- 5. Additional Services
+|   |-- a) Google Application Credentials
+|   |-- b) Ask_Dhruva
+|   |-- c) Indic_Trans_V2
+|   |-- d) Email Service
+|   |-- e) Logging
+|   |-- f) Minio
 ```
 
-Paste the value you get there into the `.env` file.
+> Note : There are some accordian so you need to expand 
 
-#### Google Cloud Logging (Optional)
 
-If Google Cloud Logging is being used, please follow these additional steps:
+<details style="background-color: #ffff;  border-radius: 5px;
+::after background-color:ffff"> 
+<summary style="background-color: #F5F5F5; color: black; padding: 5px; cursor:pointer;border-bottom:1px solid grey; padding: 5px"> 
+  1. Database Setup
+</summary>
 
-1. Install the `google-cloud-logging` library using the following command:
-```bash
-pip install google-cloud-logging
-```
-2. Follow the steps to create a Service Account from the following [Google Cloud Documentation Page](https://cloud.google.com/docs/authentication/production#create_service_account).   This will create a Service Account and generate a JSON Key for the Service Account.
-3. Ensure that atleast the Project Logs Writer role (`roles/logging.logWriter`) is assigned to the created Service Account.
-4. Add the `GOOGLE_APPLICATION_CREDENTIALS` variable to the `.env` file. This value of this variable should be the path to the JSON Key generated in Step 2. For example,
+To set up a PostgreSQL container:
+- When prompted during the script execution, enter 'Y' to include PostgreSQL installation.
+- Alternatively, manually provide the following database variables in the `.env` file:
+  - `DB_NAME`
+  - `DB_USER`
+  - `DB_PASSWORD`
+  - `DB_HOST`
+</details>
 
-```bash
-GOOGLE_APPLICATION_CREDENTIALS="/path/to/gcloud-key.json"
-```
+<details style="background-color: #ffff;  border-radius: 5px;
+::after background-color:ffff"> 
+<summary style="background-color: #F5F5F5; color: black; padding: 5px; cursor:pointer;border-bottom:1px solid grey; padding: 5px"> 
+  2. Default Components
+</summary>
 
-### Docker Installation
+This section outlines the essential setup needed for the application to function properly. It encompasses Docker deployments for Django, Celery, and Redis, which form the core components of our application infrastructure.
 
+#### a) Django
+- **Description:** Django is a Python-based framework for web development, providing tools and features to build robust web applications quickly and efficiently.
+- Configuration:
+  - `SECRET_KEY`: Django secret key either enter manually or generate using the command 
 
+  To create a new secret key, run the following commands (within the virtual environment):
+  ```
+  # Open a Python shell
+  python backend/manage.py shell
 
+  >> from django.core.management.utils import get_random_secret_key
+  >> get_random_secret_key()
+  ```
 
-```markdown
-# Application Setup Guide
+#### b) Celery
+- **Description:** Celery is a system for asynchronous task processing based on distributed message passing, allowing computationally intensive operations to run in the background without impacting the main application's performance.
+- Configuration:
+  - `CELERY_BROKER_URL`: Broker for Celery tasks
+  
 
-This guide will walk you through setting up the application using different methods and components.
+#### c) Redis
+- Description: Redis is an open-source, in-memory data structure store used as a database, cache, and message broker.
+- Configuration: 
+  - `REDIS_HOST`: Need to configue the port
+  - `REDIS_PORT` : Need to configure the port
 
-## Running the Script
+</details>
+
+<details style="background-color: #ffff;  border-radius: 5px;
+::after background-color:ffff"> 
+<summary style="background-color: #F5F5F5; color: black; padding: 5px; cursor:pointer;border-bottom:1px solid grey; padding: 5px"> 
+  3. ELK & Flower configuration
+</summary>
+
+
+#### a) Elasticsearch-Logstash-Kibanas
+This section contains the ELK stack for logging monitoring etc.
+
+- Elasticsearch
+  - Description: Elasticsearch is a distributed, RESTful search and analytics engine.
+  - Configuration:
+    - `ELASTICSEARCH_URL`: URL for Elasticsearch
+    - `INDEX_NAME`: Index name
+
+- Logstash
+  - Description: Logstash is a server-side data processing pipeline that ingests data from multiple sources simultaneously, transforms it, and then sends it to a "stash" like Elasticsearch.
+  - Configuration: None
+
+- Kibana
+  - Description: Kibana is an open-source data visualization dashboard for Elasticsearch.
+  - Configuration: None
+
+
+
+#### b) Flower Confirguation
+- Flower is a web-based tool for     monitoring and  administrating Celery clusters. It allows you to keep track of tasks as they flow through your system, inspect the 
+system's health, and perform administrative operations 
+like shutting down workers. 
+
+- Additionally, Flower would be monitoring the 
+tasks defined in our tasks/ directory in 
+the `backend/directory`. 
+
+- Configuration:
+    - `FLOWER_USERNAME`: Flower username
+    - `FLOWER_PASSWORD`: Flower password 
+    - `FLOWER_PORT`: Need to configure 
+
+</details>
 
-To run the setup script, follow these steps:
+<details style="background-color: #ffff;  border-radius: 5px;
+::after background-color:ffff"> 
+<summary style="background-color: #F5F5F5; color: black; padding: 5px; cursor:pointer;border-bottom:1px solid grey; padding: 5px"> 
+  4. Nginx-Certbot
+</summary>
 
-1. Clone this repository to your local machine.
-2. Navigate to the repository directory.
-3. Run the following command:
+This section contains Nginx and Certbot setup for serving HTTPS traffic.
 
-   ```bash
-   python setup.py
-   ```
+- Nginx
+  - Description: Nginx is a web server that can also be used as a reverse proxy, load balancer, mail proxy, and HTTP cache.
+  - Configuration: None
 
-4. Follow the prompts to select components and provide required parameters.
+- Certbot
+  - Description: Certbot is a free, open-source software tool for automatically using Let's Encrypt certificates on manually-administrated websites to enable HTTPS.
+  - Configuration: None
 
-## Components
+</details>
 
-### Default Setup
+<details style="background-color: #ffff;  border-radius: 5px;
+::after background-color:ffff"> 
+<summary style="background-color: #F5F5F5; color: black; padding: 5px; cursor:pointer;border-bottom:1px solid grey; padding: 5px"> 
+  5 Additional Services
+</summary>
 
-- **Description:** Required for the application to work. Contains a docker deployment of Django, Celery, and Redis.
-  
-  **Parameters:**
-  - `DB_NAME`
-    - **Description:** Database name.
-    - **Default:** `postgres`
-  - `DB_USER`
-    - **Description:** Database user.
-    - **Default:** `postgres`
-  - `DB_PASSWORD`
-    - **Description:** Database password.
-    - **Default:** `postgres`
-  - `DB_HOST`
-    - **Description:** Database host.
-    - **Default:** `db`
-  - `SECRET_KEY`
-    - **Description:** Django secret key.
-    - **Default:** `abcd1234`
-  - `AZURE_CONNECTION_STRING`
-    - **Description:** Azure storage string.
-    - **Default:** `AZURE_CONNECTION_STRING=DefaultEndpointsProtocol=https;AccountName=dummydeveloper;AccountKey=hello/Jm+uq4gvGgd5aloGrqVxYnRs/dgPHX0G6U4XmLCtZCIeKyNNK0n3Q9oRDNE+AStMDbqXg==;EndpointSuffix=core.windows.net`
-  - `LOGS_CONTAINER_NAME`
-    - **Description:** Logs container name.
-    - **Default:** `logs`
 
+These are the additional services that were not only present in certain confirguration but its actually present in whole files some of them  are global variables and some are services. 
+
+#### a) Google Application Credentials
+- **Description**: Google Application Credentials are used to authenticate and authorize applications to use Google Cloud APIs. They are a key part of Google Cloud's IAM (Identity and Access Management) system, and they allow the application to interact with Google's services securely.
+- Parameters:
+  - `type`
+  - `project_id`
+  - `private_key_id`
+  - `private_key`
+  - `client_email`
+  - `client_id`
+  - `auth_uri`
+  - `token_uri`
+  - `auth_provider_x509_cert_url`
+  - `client_x509_cert_url`
+  - `universe_domain`
+
+#### b) Ask_Dhruva
+- Description: Component for interacting with Dhruva ASR service.  This service is likely used in your application to convert spoken language into written text.
+- Parameters:
+  - `ASR_DHRUVA_URL`:  Parameter is used to tell your application where to send requests for speech recognition.
+  - `ASR_DHRUVA_AUTHORIZATION`: Authorization token for Dhruva ASR service. 
 
+#### c) Indic_Trans_V2
+- Description: Component for interacting with Indic Trans V2 service.
+- Parameters:
+  - `INDIC_TRANS_V2_KEY`: API key for Indic Trans V2 service
+  - `INDIC_TRANS_V2_URL`: URL for Indic Trans V2 service
 
+#### d) Email Service
+- **Description**: The Email Service is likely used in your application to send emails. This could be for a variety of purposes such as sending notifications, password resets, confirmation emails, sending reports etc.
+- Parameters:
+  - `EMAIL_HOST`
+  - `SMTP_USERNAME`
+  - `SMTP_PASSWORD`
+  - `DEFAULT_FROM_EMAIL`
 
-<!-- `cd` back to the root folder .Once inside, build the docker containers:
+#### e) Logging
+- Description:
+Logging  is used to record events or actions that occur during the execution of your program. It's a crucial part of software development for debugging and monitoring purposes
 
+- Required for the application to work. Contains a Docker deployment of Django, Celery, and Redis.
+- Parameters:
+  - `LOGGING` :  This is a boolean value (either 'true' or 
+'false') that determines whether logging is enabled. 
+  - `LOG_LEVEL` :  This sets the level of logging. 'INFO' will 
+log all INFO, WARNING, ERROR, and CRITICAL level 
+logs. 
+
+#### f) MINIO
+- Description: MinIO is an open-source, high-performance, AWS S3 compatible object storage system. It is typically used in applications for storing unstructured data like photos, videos, log files, backups, and container/VM images.
+- Parameters:
+  - `MINIO_ACCESS_KEY`
+  - `MINIO_SECRET_KEY`
+  - `MINIO_ENDPOINT`
+
+</details>
+
+### Now again resuming our setup installation 
+
+<details style="background-color: #ffff;  border-radius: 5px;
+::after background-color:ffff"> 
+<summary style="background-color: #F5F5F5; color: black; padding: 5px; cursor:pointer;border-bottom:1px solid grey; padding: 5px"> 
+Method 1 : Instruction-based prompt Interaction
+</summary>
+
+Hope you have completed step 1 and 2 above 
+
+3. Run the following command: `python deploy.py` make sure the docker engine is running on your system
+
+4. Provide the details that has been asking in the prompt and it will automatically create & run  the docker containers, volumnes and processes 
+
+3. Run the following command: `python deploy.py` make sure the docker engine is running on your system
+
+    ![installation image](public/image.png)
+
+4. Provide the details that has been asking in the prompt and it will automatically create & run  the docker containers, volumes and processes 
+    ![installation image](public/image-2.png)
+
+5. Once everything has been asked it will start creating containers and volumes and the server will get started on `http://localhost:8000` all the respective services will run on the provided ports 
+
+#### What the script does?
+- Automatically creates a Docker network named `shoonya_backend`.
+- Prompts the user to choose whether to run the application in production mode.
+- Guides the user through setting up a PostgreSQL container if desired.
+- Allows selection of components and sets up Docker Compose files accordingly.
+- Manages environment variables in the `.env` file for each selected component.
+- Deploys Docker containers for selected components.
+- Provides feedback and error handling throughout the setup process.
+
+</details>
+
+<details style="background-color: #ffff;  border-radius: 5px;
+::after background-color:ffff"> 
+<summary style="background-color: #F5F5F5; color: black; padding: 5px; cursor:pointer;border-bottom:1px solid grey; padding: 5px"> 
+Method 2 : Using Docker by running all services in containers
+</summary>
+
+3. To set up the environment variables needed for the project, run the following lines:
+
+    ```bash
+    cp .env.example ./backend/.env
+    ```
+4. Optional : Create a new secret key, run the following commands (within the virtual environment):
+    ```bash
+      # Open a Python shell
+      python backend/manage.py shell
+
+      from django.core.management.utils import get_random_secret_key
+      get_random_secret_key()```
+
+  Paste the value you get there into the `.env` file.
+
+  This creates an `.env` file at the root of the project. It is needed to make sure that the project runs correctly. Please go through the file and set the parameters according to your installation.
+
+5. `cd` back to the root folder .Once inside, build the docker 
+
+    ```bash
+    docker-compose -f docker-compose-local.yml build
+    ```
+
+    To run the containers:
+
+    ```bash
+      docker-compose -f docker-compose-local.yml up -d
+    ```
+
+    To share the database with others, just share the postgres_data and the media folder with others.
+</details>
+
+<details style="background-color: #ffff;  border-radius: 5px;
+::after background-color:ffff"> 
+<summary style="background-color: #F5F5F5; color: black; padding: 5px; cursor:pointer;border-bottom:1px solid grey; padding: 5px"> 
+Method 3 : Traditional deployment using Django manage.py runserver default script
+</summary>
+
+  3. To set up the environment variables needed for the project, run the following lines:
+
+      ```bash 
+      cp .env.example ./backend/.env
+      ```
+
+4. Update the ./backend/.env file with your own credentials 
+
+5. Run the command in the terminal to start the server  server will be running on port `8000`
+    ```bash 
+        python ./backend/manage.py runserver
+    ```
+</details>
+
+
+
+#### Google Cloud Logging (Optional)
+
+If Google Cloud Logging is being used, please follow these additional steps:
+
+1. Install the `google-cloud-logging` library using the following command:
 ```bash
-docker-compose -f docker-compose-local.yml build
+pip install google-cloud-logging
 ```
-
-To run the containers:
+2. Follow the steps to create a Service Account from the following [Google Cloud Documentation Page](https://cloud.google.com/docs/authentication/production#create_service_account).   This will create a Service Account and generate a JSON Key for the Service Account.
+3. Ensure that atleast the Project Logs Writer role (`roles/logging.logWriter`) is assigned to the created Service Account.
+4. Add the `GOOGLE_APPLICATION_CREDENTIALS` variable to the `.env` file. This value of this variable should be the path to the JSON Key generated in Step 2. For example,
 
 ```bash
-docker-compose -f docker-compose-local.yml up -d
+GOOGLE_APPLICATION_CREDENTIALS="/path/to/gcloud-key.json"
 ```
 
-To share the database with others, just share the postgres_data and the media folder with others.
 
 ### Run Migrations (required only for the first time running the project or if you make any changes in the models)
 Run the following commands:
@@ -150,8 +401,7 @@ docker-compose exec web python manage.py migrate
 
 # Create a superuser
 docker-compose exec web python manage.py createsuperuser
-
-``` -->
+``` 
 
 
 
@@ -206,7 +456,7 @@ celery command - celery -A shoonya_backend.celery worker -l info
 celery command - celery -A shoonya_backend.celery beat --loglevel=info
 ```
 
-You can set use the celery to local by modifying CELERY_BROKER_URL = "redis://localhost:6379/0" in ./backend/shoonya_backend/settings.py.
+You can set use the celery to local by modifying `CELERY_BROKER_URL = "redis://localhost:6379/0"` in ./backend/shoonya_backend/settings.py.
 
 We can set the concurrency and autoscale in the process as well to manage the number of worker processes in the background. Read more [here](https://stackoverflow.com/a/72366865/9757174). 
 
@@ -226,3 +476,4 @@ black ./backend/
 ```
 
 Happy Coding!!
+
diff --git a/oldReadme.md b/oldReadme.md
new file mode 100644
index 000000000..4889df792
--- /dev/null
+++ b/oldReadme.md
@@ -0,0 +1,226 @@
+# Shoonya Backend
+
+Repository for Shoonya's backend.
+
+## Pre-requisites
+
+The project was created using [Python 3.7](https://www.python.org/downloads/). All major dependencies along with the versions are listed in the `backend/deploy/requirements.txt` file.
+
+## Installation
+
+The installation and setup instructions have been tested on the following platforms:
+
+It can be done in 2 ways:-
+1) using docker by running all services in containers or
+2) directly running the services on local one by one (like, celery and redis).
+   
+If your preference is 1 over 2 please be fixed to this environment and follow the steps below it:
+
+- Docker
+- Ubuntu 20.04 OR macOs 
+
+If you are using a different operating system, you will have to look at external resources (eg. StackOverflow) to correct any errors.
+
+### Create a Virtual Environment
+
+We recommend you to create a virtual environment to install all the dependencies required for the project.
+
+```bash
+python3 -m venv <YOUR-ENVIRONMENT-NAME>
+source <YOUR-ENVIRONMENT-NAME>/bin/activate # this command may be different based on your OS
+
+# Install dependencies
+pip install -r deploy/requirements-dev.txt
+```
+
+### Environment file
+
+To set up the environment variables needed for the project, run the following lines:
+```bash
+cp .env.example ./backend/.env
+```
+
+This creates an `.env` file at the root of the project. It is needed to make sure that the project runs correctly. Please go through the file and set the parameters according to your installation.
+
+To create a new secret key, run the following commands (within the virtual environment):
+```bash
+# Open a Python shell
+python backend/manage.py shell
+
+>> from django.core.management.utils import get_random_secret_key
+>> get_random_secret_key()
+```
+
+Paste the value you get there into the `.env` file.
+
+#### Google Cloud Logging (Optional)
+
+If Google Cloud Logging is being used, please follow these additional steps:
+
+1. Install the `google-cloud-logging` library using the following command:
+```bash
+pip install google-cloud-logging
+```
+2. Follow the steps to create a Service Account from the following [Google Cloud Documentation Page](https://cloud.google.com/docs/authentication/production#create_service_account).   This will create a Service Account and generate a JSON Key for the Service Account.
+3. Ensure that atleast the Project Logs Writer role (`roles/logging.logWriter`) is assigned to the created Service Account.
+4. Add the `GOOGLE_APPLICATION_CREDENTIALS` variable to the `.env` file. This value of this variable should be the path to the JSON Key generated in Step 2. For example,
+
+```bash
+GOOGLE_APPLICATION_CREDENTIALS="/path/to/gcloud-key.json"
+```
+
+### Docker Installation
+
+
+```markdown
+# Application Setup Guide
+
+This guide will walk you through setting up the application using different methods and components.
+
+## Running the Script
+
+To run the setup script, follow these steps:
+
+1. Clone this repository to your local machine.
+2. Navigate to the repository directory.
+3. Run the following command:
+
+   ```bash
+   python setup.py
+   ```
+
+4. Follow the prompts to select components and provide required parameters.
+
+## Components
+
+### Default Setup
+
+- **Description:** Required for the application to work. Contains a docker deployment of Django, Celery, and Redis.
+  
+  **Parameters:**
+  - `DB_NAME`
+    - **Description:** Database name.
+    - **Default:** `postgres`
+  - `DB_USER`
+    - **Description:** Database user.
+    - **Default:** `postgres`
+  - `DB_PASSWORD`
+    - **Description:** Database password.
+    - **Default:** `postgres`
+  - `DB_HOST`
+    - **Description:** Database host.
+    - **Default:** `db`
+  - `SECRET_KEY`
+    - **Description:** Django secret key.
+    - **Default:** `abcd1234`
+  - `AZURE_CONNECTION_STRING`
+    - **Description:** Azure storage string.
+    - **Default:** `AZURE_CONNECTION_STRING=DefaultEndpointsProtocol=https;AccountName=dummydeveloper;AccountKey=hello/Jm+uq4gvGgd5aloGrqVxYnRs/dgPHX0G6U4XmLCtZCIeKyNNK0n3Q9oRDNE+AStMDbqXg==;EndpointSuffix=core.windows.net`
+  - `LOGS_CONTAINER_NAME`
+    - **Description:** Logs container name.
+    - **Default:** `logs`
+
+
+
+
+<!-- `cd` back to the root folder .Once inside, build the docker containers:
+
+```bash
+docker-compose -f docker-compose-local.yml build
+```
+
+To run the containers:
+
+```bash
+docker-compose -f docker-compose-local.yml up -d
+```
+
+To share the database with others, just share the postgres_data and the media folder with others.
+
+### Run Migrations (required only for the first time running the project or if you make any changes in the models)
+Run the following commands:
+```bash
+# Check if there are any pending migrations
+docker-compose exec web python manage.py makemigrations 
+
+# Run all pending migrations
+docker-compose exec web python manage.py migrate
+
+# Create a superuser
+docker-compose exec web python manage.py createsuperuser
+
+``` -->
+
+
+
+If there were no errors, congratulations! The project is up and running.
+
+If your preference is 2 over 1 please be fixed to this environment and follow the steps below it:
+
+- Ubuntu 20.04 OR macOs
+
+You can run the following script and each and every step for setting the codebase will be done directly. Please move to a folder in your local where you would like to store the code and run the script given below there:
+```bash
+os=$(uname)
+
+if [ "$os" = "Linux" ] || [ "$os" = "Darwin" ]; then
+
+git clone https://github.com/AI4Bharat/Shoonya-Backend.git
+cd Shoonya-Backend
+git checkout dev
+git pull origin dev
+cp .env.example ./backend/.env
+cd backend
+python3 -m venv  venv
+source venv/bin/activate
+
+pip install -r ./deploy/requirements.txt
+
+new_secret_key=$(python3 -c "from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())")
+
+env_file=".env"
+if sed --version 2>&1 | grep -q 'GNU sed'; then
+  sed -i "/^SECRET_KEY=/d" "$env_file"
+else
+  sed -i.bak "/^SECRET_KEY=/d" "$env_file"
+  rm -f "$env_file.bak"
+fi
+
+echo "SECRET_KEY='$new_secret_key'" >> "$env_file"
+
+echo "New secret key has been generated and updated in $env_file"
+
+else
+  echo "Cannot run this script on: $os"
+fi
+  ```
+
+### Running background tasks 
+Please install and run redis from https://redis.io/download/ on port 6379 before starting celery. 
+
+To run background tasks for project creation, we need to run the following command in the terminal. This has also been added into the `docker-compose.yml` file.
+```bash 
+celery command - celery -A shoonya_backend.celery worker -l info
+celery command - celery -A shoonya_backend.celery beat --loglevel=info
+```
+
+You can set use the celery to local by modifying CELERY_BROKER_URL = "redis://localhost:6379/0" in ./backend/shoonya_backend/settings.py.
+
+We can set the concurrency and autoscale in the process as well to manage the number of worker processes in the background. Read more [here](https://stackoverflow.com/a/72366865/9757174). 
+
+The commands will be as follows 
+```bash 
+celery -A shoonya_backend.celery worker --concurrency=2 --loglevel=info
+celery -A shoonya_backend.celery worker --autoscale=10,3 --loglevel=info
+```
+
+### Running Linters
+
+In case you want to raise a PR, kindly run linters as specified below. You can install black by running pip install black and use `black` 
+To run `black` do:
+
+```bash
+black ./backend/
+```
+
+Happy Coding!!
diff --git a/public/image-2.png b/public/image-2.png
new file mode 100644
index 0000000000000000000000000000000000000000..644d35d9a22bc0ef095dfec86633e56e581d4c22
GIT binary patch
literal 54688
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

literal 0
HcmV?d00001

diff --git a/public/image.png b/public/image.png
new file mode 100644
index 0000000000000000000000000000000000000000..78b8c53782d9f473a4d5edc59ed4c730e739a044
GIT binary patch
literal 51199
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

literal 0
HcmV?d00001


From 4f32bf31a7581962954a5833d61c08be5f93c6b9 Mon Sep 17 00:00:00 2001
From: Pursottam6003 <rahulsah6003@gmail.com>
Date: Mon, 6 May 2024 10:46:58 +0530
Subject: [PATCH 15/16] updated black linting on docker-setup.py

---
 default-setup.py | 11 +++++------
 docker-setup.py  |  2 --
 2 files changed, 5 insertions(+), 8 deletions(-)

diff --git a/default-setup.py b/default-setup.py
index f9a60379b..9edd27ce3 100644
--- a/default-setup.py
+++ b/default-setup.py
@@ -5,12 +5,15 @@
 import shutil
 import string
 import random
+
+
 def generate_secret_key(length=50):
     """
     Generate a random Django secret key.
     """
     characters = string.ascii_letters + string.digits + "!@#$%^&*(-_=+)"
-    return ''.join(random.choice(characters) for _ in range(length))
+    return "".join(random.choice(characters) for _ in range(length))
+
 
 def install_dependencies():
     # Create a virtual environment
@@ -29,7 +32,6 @@ def install_dependencies():
 def setup_env_file():
     # Copy .env.example to .env
     shutil.copy(".env.example", "./backend/.env")
-   
 
     # Generate a new secret key
     new_secret_key = generate_secret_key()
@@ -40,7 +42,6 @@ def setup_env_file():
 
 
 def run_celery_instances():
-
     # Activate the virtual environment
     if sys.platform == "win32":
         activate_script = os.path.join("venv", "Scripts", "activate.bat")
@@ -48,10 +49,8 @@ def run_celery_instances():
         activate_script = os.path.join("venv", "bin", "activate")
     subprocess.run([activate_script])
 
-
-    
     os.chdir("backend")
-    
+
     # Start Celery workers
     celery_worker_process = subprocess.Popen(
         [
diff --git a/docker-setup.py b/docker-setup.py
index 78f94194e..75edcac5b 100644
--- a/docker-setup.py
+++ b/docker-setup.py
@@ -271,12 +271,10 @@
     "AZURE_CONNECTION_STRING": {
         "help": "AZURE storage string",
         "default": "AZURE_CONNECTION_STRING=DefaultEndpointsProtocol=https;AccountName=dummydeveloper;AccountKey=hello/Jm+uq4gvGgd5aloGrqVxYnRs/dgPHX0G6U4XmLCtZCIeKyNNK0n3Q9oRDNE+AStMDbqXg==;EndpointSuffix=core.windows.net",
-        
     },
     "LOGS_CONTAINER_NAME": {
         "help": "Logs container name",
         "default": "logs",
-        
     },
 }
 

From b9e885ed86cc1aac7f490f98a54005d0a62e1bfd Mon Sep 17 00:00:00 2001
From: Pursottam6003 <rahulsah6003@gmail.com>
Date: Tue, 7 May 2024 00:09:20 +0530
Subject: [PATCH 16/16] updated readme.md file based on the review

---
 README.md | 214 +++++++++++++++++++-----------------------------------
 1 file changed, 74 insertions(+), 140 deletions(-)

diff --git a/README.md b/README.md
index c555e5553..32cd76f34 100644
--- a/README.md
+++ b/README.md
@@ -6,10 +6,6 @@ Repository for Shoonya's backend.
 
 The project was created using [Python 3.7](https://www.python.org/downloads/). All major dependencies along with the versions are listed in the `backend/deploy/requirements.txt` file.
 
-## Setup and Installation
-
-Please follow the below instructions for setup and installation. These steps have been verified on the following operating systems:
-
 
 | Systems   | Requirements |
 | --------- | ------------ |
@@ -18,80 +14,22 @@ Please follow the below instructions for setup and installation. These steps hav
 | Unix/Mac  | macOS 10.13 or later with at least 4GB of RAM. |
 
 
-The installation can be done in three ways, each with its own advantages:
-
-1. **Instruction-based prompt Interaction**: This is the latest, easiest, and most hassle-free installation method. All services will be run under Docker containers and volumes, ensuring a consistent environment and simplifying the setup process.
-
-2. **Using Docker by running all services in containers**: This method also uses Docker, but requires running a single compose file. While this method is also straightforward, it might throw errors if the compose file is not correctly configured or if there are issues with the Docker setup.
-
-3. **Traditional deployment using Django manage.py runserver default script**: This method involves running the services locally one by one (like Celery and Redis). While this method gives you the most control and visibility into each service, it is more complex and time-consuming. Also, asynchronous tasks won't work under Celery tasks in this setup.
-
-## Prerequisites
-
-### Create a Virtual Environment
-
-We recommend you to create a virtual environment to install all the dependencies required for the project.
-
-For **Ubuntu/Mac**:
-
-```bash
-python3 -m venv <YOUR-ENVIRONMENT-NAME>
-source <YOUR-ENVIRONMENT-NAME>/bin/activate
-```
-For **Windows**:
-```bash
-python -m venv <YOUR-ENVIRONMENT-NAME>
-<YOUR-ENVIRONMENT-NAME>\Scripts\activate
-```
-
-If you are choosing 1st or 2nd method then you need to install Docker on your system
-
-- **Docker Engine/Docker Desktop running** 
-    You may download Docker Desktop from the table given below 
-        
-  | Systems| Link |
-  | ---------- | ------ |
-  | Windows | https://docs.docker.com/desktop/install/windows-install/ |
-  | Ubuntu | https://docs.docker.com/desktop/install/ubuntu/ |
-  | Unix/Mac | https://docs.docker.com/desktop/install/mac-install/|
-- Python Version 3.7 or above 
-- An Azure account subscription.
-
-## Running the Setup Script
-
-To run the setup script:
-1. Clone this repository to your local machine.
-
-```bash
-git clone "https://github.com/AI4Bharat/Shoonya-Backend"
-```
-2. Navigate to the root directory of the project.
-```bash 
-cd Shoonya-Backend
-pip install -r ./backend/deploy/requirements.txt
-```
-
-Now choosing the best option for  Installation method (mentioned above) It is important to know brief about them 
-
-> Note : You may skip this section if you are already familiar with the concepts, but reviewing it could enhance your understanding of the backend setup.
 
-## Backend Components 
+## Backend Components and Services
 The whole backend setup is divided into mainly 5 Components 
 ```
-Backend Setup
-|
-|-- 1. Database Setup
+Backend Comopnents 
 |
-|-- 2. Default Components
+|-- 1. Default Components
 |   |-- a) Django
 |   |-- b) Celery
 |   |-- c) Redis
 |
-|-- 3. Elastic Logstash Kibana (ELK) & Flower Confirguration
+|-- 2. Elastic Logstash Kibana (ELK) & Flower Confirguration
 |
-|-- 4. Nginx-Certbot 
+|-- 3. Nginx-Certbot 
 |
-|-- 5. Additional Services
+|-- 4. Additional Services
 |   |-- a) Google Application Credentials
 |   |-- b) Ask_Dhruva
 |   |-- c) Indic_Trans_V2
@@ -102,26 +40,10 @@ Backend Setup
 
 > Note : There are some accordian so you need to expand 
 
-
 <details style="background-color: #ffff;  border-radius: 5px;
 ::after background-color:ffff"> 
 <summary style="background-color: #F5F5F5; color: black; padding: 5px; cursor:pointer;border-bottom:1px solid grey; padding: 5px"> 
-  1. Database Setup
-</summary>
-
-To set up a PostgreSQL container:
-- When prompted during the script execution, enter 'Y' to include PostgreSQL installation.
-- Alternatively, manually provide the following database variables in the `.env` file:
-  - `DB_NAME`
-  - `DB_USER`
-  - `DB_PASSWORD`
-  - `DB_HOST`
-</details>
-
-<details style="background-color: #ffff;  border-radius: 5px;
-::after background-color:ffff"> 
-<summary style="background-color: #F5F5F5; color: black; padding: 5px; cursor:pointer;border-bottom:1px solid grey; padding: 5px"> 
-  2. Default Components
+  1. Default Components
 </summary>
 
 This section outlines the essential setup needed for the application to function properly. It encompasses Docker deployments for Django, Celery, and Redis, which form the core components of our application infrastructure.
@@ -157,7 +79,7 @@ This section outlines the essential setup needed for the application to function
 <details style="background-color: #ffff;  border-radius: 5px;
 ::after background-color:ffff"> 
 <summary style="background-color: #F5F5F5; color: black; padding: 5px; cursor:pointer;border-bottom:1px solid grey; padding: 5px"> 
-  3. ELK & Flower configuration
+  2. ELK & Flower configuration
 </summary>
 
 
@@ -199,7 +121,7 @@ the `backend/directory`.
 <details style="background-color: #ffff;  border-radius: 5px;
 ::after background-color:ffff"> 
 <summary style="background-color: #F5F5F5; color: black; padding: 5px; cursor:pointer;border-bottom:1px solid grey; padding: 5px"> 
-  4. Nginx-Certbot
+  3. Nginx-Certbot
 </summary>
 
 This section contains Nginx and Certbot setup for serving HTTPS traffic.
@@ -217,7 +139,7 @@ This section contains Nginx and Certbot setup for serving HTTPS traffic.
 <details style="background-color: #ffff;  border-radius: 5px;
 ::after background-color:ffff"> 
 <summary style="background-color: #F5F5F5; color: black; padding: 5px; cursor:pointer;border-bottom:1px solid grey; padding: 5px"> 
-  5 Additional Services
+  4 Additional Services
 </summary>
 
 
@@ -279,21 +201,48 @@ logs.
 
 </details>
 
-### Now again resuming our setup installation 
+## Setup Instructions
 
-<details style="background-color: #ffff;  border-radius: 5px;
-::after background-color:ffff"> 
-<summary style="background-color: #F5F5F5; color: black; padding: 5px; cursor:pointer;border-bottom:1px solid grey; padding: 5px"> 
-Method 1 : Instruction-based prompt Interaction
-</summary>
+The installation can be done in two ways, each with its own advantages:
 
-Hope you have completed step 1 and 2 above 
+1. **Dockerize Installation**: This is the latest, easiest, and most hassle-free installation method. All services will be run under Docker containers and volumes, ensuring a consistent environment and simplifying the setup process.
 
-3. Run the following command: `python deploy.py` make sure the docker engine is running on your system
+2. **Default Installation (Without Docker)**: This method involves running the services locally one by one (like Celery and Redis). While this method gives you the most control and visibility into each service, it is more complex and time-consuming. Also, asynchronous tasks won't work under Celery tasks in this setup.
 
-4. Provide the details that has been asking in the prompt and it will automatically create & run  the docker containers, volumnes and processes 
+### 1. Dockerize Installation 
 
-3. Run the following command: `python deploy.py` make sure the docker engine is running on your system
+###  Pre-requisites
+ 
+If you are choosing dockerize method then you need to install following things
+
+- **Docker Engine/Docker Desktop running** 
+    You may download Docker Desktop from the table given below 
+        
+  | Systems| Link |
+  | ---------- | ------ |
+  | Windows | https://docs.docker.com/desktop/install/windows-install/ |
+  | Ubuntu | https://docs.docker.com/desktop/install/ubuntu/ |
+  | Unix/Mac | https://docs.docker.com/desktop/install/mac-install/|
+- Python Version 3.7 or above 
+- An Azure account subscription.
+- Google cloud subscriptions (mentioned above the backend components)
+
+
+### Running the Setup Script
+
+To run the setup script:
+1. Clone this repository to your local machine.
+
+    ```bash
+    git clone "https://github.com/AI4Bharat/Shoonya-Backend"
+    ```
+2. Navigate to the root directory of the project.
+    ```bash 
+    cd Shoonya-Backend
+    pip install -r ./backend/deploy/requirements.txt
+    ```
+
+3. Run the following command: `python docker-setup.py` make sure the docker engine is running on your system
 
     ![installation image](public/image.png)
 
@@ -302,7 +251,7 @@ Hope you have completed step 1 and 2 above
 
 5. Once everything has been asked it will start creating containers and volumes and the server will get started on `http://localhost:8000` all the respective services will run on the provided ports 
 
-#### What the script does?
+### What the script does?
 - Automatically creates a Docker network named `shoonya_backend`.
 - Prompts the user to choose whether to run the application in production mode.
 - Guides the user through setting up a PostgreSQL container if desired.
@@ -311,53 +260,41 @@ Hope you have completed step 1 and 2 above
 - Deploys Docker containers for selected components.
 - Provides feedback and error handling throughout the setup process.
 
-</details>
 
-<details style="background-color: #ffff;  border-radius: 5px;
-::after background-color:ffff"> 
-<summary style="background-color: #F5F5F5; color: black; padding: 5px; cursor:pointer;border-bottom:1px solid grey; padding: 5px"> 
-Method 2 : Using Docker by running all services in containers
-</summary>
+### 2. Default Installation (Without Docker) 
 
-3. To set up the environment variables needed for the project, run the following lines:
+###  Pre-requisites
 
-    ```bash
-    cp .env.example ./backend/.env
-    ```
-4. Optional : Create a new secret key, run the following commands (within the virtual environment):
-    ```bash
-      # Open a Python shell
-      python backend/manage.py shell
+#### Create a Virtual Environment
 
-      from django.core.management.utils import get_random_secret_key
-      get_random_secret_key()```
-
-  Paste the value you get there into the `.env` file.
-
-  This creates an `.env` file at the root of the project. It is needed to make sure that the project runs correctly. Please go through the file and set the parameters according to your installation.
-
-5. `cd` back to the root folder .Once inside, build the docker 
+We recommend you to create a virtual environment to install all the dependencies required for the project.
 
-    ```bash
-    docker-compose -f docker-compose-local.yml build
-    ```
+For **Ubuntu/Mac**:
 
-    To run the containers:
+```bash
+python3 -m venv <YOUR-ENVIRONMENT-NAME>
+source <YOUR-ENVIRONMENT-NAME>/bin/activate
+```
+For **Windows**:
+```bash
+python -m venv <YOUR-ENVIRONMENT-NAME>
+<YOUR-ENVIRONMENT-NAME>\Scripts\activate
+```
 
-    ```bash
-      docker-compose -f docker-compose-local.yml up -d
-    ```
+#### Running the Setup Script
 
-    To share the database with others, just share the postgres_data and the media folder with others.
-</details>
+  1. Clone this repository to your local machine.
 
-<details style="background-color: #ffff;  border-radius: 5px;
-::after background-color:ffff"> 
-<summary style="background-color: #F5F5F5; color: black; padding: 5px; cursor:pointer;border-bottom:1px solid grey; padding: 5px"> 
-Method 3 : Traditional deployment using Django manage.py runserver default script
-</summary>
+      ```bash
+      git clone "https://github.com/AI4Bharat/Shoonya-Backend"
+      ```
+  2. Navigate to the root directory of the project.
+      ```bash 
+      cd Shoonya-Backend
+      pip install -r ./backend/deploy/requirements.txt
+      ```
 
-  3. To set up the environment variables needed for the project, run the following lines:
+ 3. To set up the environment variables needed for the project, run the following lines:
 
       ```bash 
       cp .env.example ./backend/.env
@@ -369,11 +306,8 @@ Method 3 : Traditional deployment using Django manage.py runserver default scrip
     ```bash 
         python ./backend/manage.py runserver
     ```
-</details>
-
-
 
-#### Google Cloud Logging (Optional)
+### Google Cloud Logging (Optional)
 
 If Google Cloud Logging is being used, please follow these additional steps: