orphan: clean tree ready for push to hugspace

Dockerfile

@@ -0,0 +1,82 @@
+#--- PREREQS:  
+#   - https://huggingface.co/spaces/radames/nginx-gradio-reverse-proxy/tree/main
+#   - https://muellerzr.github.io/blog/huggingface_docker.html
+#   - https://www.tecmint.com/enable-nginx-status-page/
+
+#--- USAGE:
+#--- to build/rebuild the image;  make sure you stop and remove the container if you are replacing/upgrading;  or change the version tag# from 0.0.1
+#--- to tag the image prior to push to DockerHub;  docker login and then register user/image:tag
+#--- to push this image to DockerHub, example based on the repo:  kidcoconut73/<img>
+
+#   docker build -t img_nginx_hugspace:0.0.1 .
+#   docker create -it -p 49130:39130 --name ctr_nginx_hugspace img_nginx_hugspace:0.0.1
+#   docker start -it ctr_nginx_hugspace
+
+#   docker run -it -p 7860:7860 -p 49131:39131 -p 49132:39132 --name ctr_nginx_templ img_nginx_templ:0.0.1
+
+#   docker push kidcoconut73/<img:tag>
+
+
+#--- use a base image of python
+FROM python:3.8-slim-buster
+
+
+# Install nginx and give permissions to 'pn'
+# See https://www.rockyourcode.com/run-docker-nginx-as-non-root-user/
+USER root
+
+#$ apt list --installed | grep nginx;  1.22.1-9
+RUN apt-get -y update && apt-get -y install nginx
+
+RUN mkdir -p /var/cache/nginx \
+             /var/log/nginx \
+             /var/lib/nginx
+RUN touch /var/run/nginx.pid
+
+RUN groupadd user
+RUN useradd -d /home/user -ms /bin/bash -g user -G user -p user user
+RUN chown -R user:user /var/cache/nginx \
+                       /var/log/nginx \
+                       /var/lib/nginx \
+                       /var/run/nginx.pid
+
+#--- update nginx config;  establish routes/proxy pass;  remove user directive
+COPY ./nginx/etc.nginx.confd_default.conf /etc/nginx/conf.d/default.conf
+COPY ./nginx/etc.nginx_nginx.conf /etc/nginx/nginx.conf
+#COPY ./nginx/etc.nginx.sites-available.default /etc/nginx/sites-available/default
+
+
+#--- Install dependencies and build app as non-root
+USER user
+ENV HOME=/home/user \
+    PATH=/home/user/.local/bin:$PATH
+
+#--- set docker image working directory to /app
+RUN mkdir $HOME/app
+WORKDIR $HOME/app
+
+#--- install all lib dependencies into the image
+COPY --chown=user ./requirements.txt ./requirements.txt
+RUN pip install --no-cache-dir -r ./requirements.txt
+
+#--- copy  files from the local pwd to the docker image /app folder
+#--- .dockerignore:  ensure no local data folders or files (images) are copied into the docker image/container 
+COPY --chown=user ./_env_config/stg_dev/utl_dkr_preRun.sh ./scripts/docker/
+COPY --chown=user ./fastapi ./fastapi
+COPY --chown=user ./gradio ./gradio
+COPY --chown=user ./streamlit ./streamlit
+
+#--- for nginx reverse proxy;  external 49130;  internal 39130
+#--- for streamlit;  external 49131;  internal 39131
+#--- for fastapi;  external 49132;  internal 39132
+#--- for huggingface;  assume 1:1 mapping between internal and external ports;  and only one port can truly be exposed
+EXPOSE 7860
+EXPOSE 49131
+EXPOSE 49132
+
+#--- establish environment prereqs
+#CMD ls -la /app/scripts/docker
+ENTRYPOINT [ "./scripts/docker/utl_dkr_preRun.sh" ]
+
+
+#--- WORKAROUND:  you may have to stop the docker container through docker desktop, or cmd line eg docker kill <ctr_name>

README.md

@@ -0,0 +1,21 @@
+---
+title: spcdkr nginx templ
+emoji: 📉
+colorFrom: purple
+colorTo: pink
+sdk: docker
+app_port: 7860
+pinned: false
+license: mit
+---
+
+This app is publically available and run at https://kidcoconut-dkr-nginx-templ.hf.space/  
+example endpoint:    https://kidcoconut-dkr-fastapi-templ.hf.space/sanity  
+example endpoint:    https://kidcoconut-dkr-fastapi-templ.hf.space/syscheck/sanity  
+  
+streamlit endpoint:  https://kidcoconut-dkr-nginx-templ.hf.space/     [web | streamlit]  
+fastapi endpoint:     https://kidcoconut-dkr-nginx-templ.hf.space/api    [api | fastapi]  
+gradio:                   https://kidcoconut-dkr-nginx-templ.hf.space/gradio  
+docs:                      https://kidcoconut-dkr-nginx-templ.hf.space/docs  
+  
+Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference  

_env_config/stg_dev/utl_dkr_preRun.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+
+#--- Note:  this file is designed to run locally as well as within docker to prep the environment
+#--- Entry:  this script is assumed to run from the /app root folder
+#--- Usage:  ./_env_config/local_dev/utl_dkr_preRun.sh
+
+#--- for volume initialization; ensure folders are in place; assume:  we are in the /app folder
+
+
+<<blockComment 
+- 
+blockComment
+echo -e "INFO(utl_dkr_preRun):\t Initializing ..."
+
+strpth_pwd=$(pwd)
+strpth_scriptLoc=$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )
+strpth_scrHome="${strpth_scriptLoc}/../"
+strpth_appHome="${strpth_scrHome}../"
+strpth_scrModels="${strpth_scrHome}models/"
+
+#echo "strpth_appHome = ${strpth_appHome}"
+
+#--- for nginx;  external 7860;  internal 7860
+service nginx start
+
+#--- for fastapi;  external 49132;  internal 39132
+echo "INFO:  starting fastapi ..."
+uvicorn --app-dir=./fastapi entry_fastapi:app --reload --workers 1 --host 0.0.0.0 --port 39132 &          #--- specify a non-root app dir
+
+
+#--- for streamlit;  external 49131;  internal 39131
+echo "INFO:  starting streamlit ..."
+streamlit run ./streamlit/entry_streamlit.py --server.port=39131 --server.maxUploadSize=2000            #--- & run in the background
+
+
+
+<<blockErrorLog
+blockErrorLog

fastapi/ABOUTME.md

@@ -0,0 +1,6 @@
+#   ABOUTME:  fastapi
+##      Purpose:    this environment is used to API endpoints
+##      Prereq:     
+##      - 
+
+

fastapi/entry_fastapi.py

@@ -0,0 +1,159 @@
+'''
+    purpose:     fastAPI routing 
+
+    refs:
+        fast api behind proxy/root_path:    https://fastapi.tiangolo.com/advanced/behind-a-proxy/
+'''
+
+from fastapi import FastAPI
+from fastapi.responses import HTMLResponse, RedirectResponse
+from fastapi import APIRouter, Request, Response
+from fastapi.templating import Jinja2Templates
+import uvicorn
+import gradio as gr
+
+#--- import custom libraries
+#import lib.utils as libUtils
+
+
+#--- imported route handlers
+#from routes.api.rte_api import rteApi
+
+
+#--- fastAPI self doc descriptors
+description = """
+    Prototype:  FastApi in Docker on Huggingface
+    
+    <insert purpose>
+
+    ## key business benefit #1
+    ## key business benefit #2
+    ## key business benefit #3
+
+    You will be able to:
+    * key feature #1
+    * key feature #2
+    * key feature #3
+"""
+
+#--- main fast api app
+app = FastAPI(
+    title="Prototype:  Fastapi in docker",
+    description=description,
+    version="0.0.1",
+    terms_of_service="http://example.com/terms/",
+    contact={
+        "name": "Iain McKone",
+        "email": "iain.mckone@gmail.com",
+    },
+    license_info={
+        "name": "MIT",
+        "url": "http://opensource.org/licenses/MIT",
+    },
+    openapi_url="/api/v1/openapi.json"
+)
+
+io = gr.Interface(lambda x: "Hello, " + x + "!", "textbox", "textbox")
+app = gr.mount_gradio_app(app, io, path="/gradio_svc")
+
+
+#--- configure route handlers
+#app.include_router(rteApi, prefix="/api")
+#app.include_router(rteQa, prefix="/qa")
+
+
+#m_kstrPath_templ = libUtils.pth_templ
+#m_templRef = Jinja2Templates(directory=str(m_kstrPath_templ))
+
+
+""" def get_jinja2Templ(request: Request, pdfResults, strParamTitle, lngNumRecords, blnIsTrain=False, blnIsSample=False):
+    lngNumRecords = min(lngNumRecords, libUtils.m_klngMaxRecords)
+    if (blnIsTrain):  strParamTitle = strParamTitle + " - Training Data"
+    if (not blnIsTrain):  strParamTitle = strParamTitle + " - Test Data"
+    if (blnIsSample):  lngNumRecords = libUtils.m_klngSampleSize
+    strParamTitle = strParamTitle + " - max " + str(lngNumRecords) + " rows"
+
+    kstrTempl = 'templ_showDataframe.html'
+    jsonContext = {'request': request, 
+                'paramTitle': strParamTitle,
+                'paramDataframe': pdfResults.sample(lngNumRecords).to_html(classes='table table-striped')
+            }
+    result = m_templRef.TemplateResponse(kstrTempl, jsonContext)
+    return result """
+
+
+#--- get main ui/ux entry point
+@app.get('/')
+def index():
+
+    return {
+        "message": "Landing page:  prototype for fastApi"
+    }
+
+@app.get('/api')
+def rte_api():
+
+    return {
+        "message": "Landing page:  prototype for fastApi"
+    }
+
+@app.get('/gradio')
+def rte_gradio():
+
+    #return {
+    #    "message": "Landing page:  this is where gradio would start from if we could mount with fastapi"
+    #} 
+    return RedirectResponse("/gradio_svc")
+
+
+@app.get('/streamlit')
+def rte_streamlit():
+
+    return {
+        "message": "Landing page:  this is where streamlit would start from if we could mount with fastapi"
+    }
+
+@app.get('/shiny')
+def rte_shiny():
+
+    return {
+        "message": "Landing page:  this is where shiny would start mounted with fastapi"
+    }
+
+@app.get('/syscheck/{check_id}')
+async def syscheck(check_id: str): 
+    from os import system
+    #import commands
+
+    print("TRACE: fastapi.syscheck ... {check_id} ", check_id)
+
+    if (check_id=='apt_list'): 
+        print("TRACE: fastapi.syscheck ... {apt_list} ")
+        m_sysMsg = system("apt list --installed")
+        return {"message:  syscheck apt list complete " + str(m_sysMsg)}    
+
+    elif (check_id=='sanity'):
+        print("TRACE: fastapi.syscheck ... {}".format(check_id))
+        return {"message:  syscheck sanity ... ok "} 
+        
+    elif (check_id=='pip_list'): 
+        print("TRACE: fastapi.syscheck ... {pip_list} ")
+        m_sysMsg = system("pip list")
+        return {"message:  syscheck pip list complete " + str(m_sysMsg)}    
+
+    else:
+        return {"message": "fastApi: syscheck {check_id} " + check_id}
+
+
+@app.get('/sanity')
+async def sanity():
+    print("TRACE: fastapi.sanity ... {}")
+    return {"message:  syscheck sanity ... ok "} 
+
+
+if __name__ == '__main__':
+    #uvicorn.run("main:app", host="0.0.0.0", port=49132, reload=True)
+    #uvicorn --app-dir=./fastapi entry_fastapi:app --reload --workers 1 --host 0.0.0.0 --port 7860 &          #--- specify a non-root app dir
+    uvicorn.run("fastapi.entry_fastapi:app", reload=True, workers=1, host="0.0.0.0", port=49132)
+#CMD ["uvicorn", "main:app", "--host=0.0.0.0", "--reload"]
+

gradio/ABOUTME.md

@@ -0,0 +1,6 @@
+#   ABOUTME:  gradio
+##      Purpose:    this environment is used to host a gradio UI
+##      Prereq:     
+##      - 
+
+

nginx/etc.nginx.confd_default.conf

@@ -0,0 +1,94 @@
+server {
+    #listen         80;
+    listen          7860;
+    server_name     localhost;
+
+    #access_log  /var/log/nginx/host.access.log  main;
+
+    #--- Note:  we have a basic web server with entry points and routes
+
+
+    #--- streamlit
+    location / {
+        proxy_pass http://127.0.0.1:39131/;                     #--- default streamlit landing page
+        proxy_http_version 1.1;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header Host $host;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+        proxy_read_timeout 86400;
+    }
+    location ~ ^/(streamlit|web)/ {
+        rewrite ^/streamlit/(.*) /$1 last;
+        rewrite ^/web/(.*) /$1 last;
+        return 403; 
+    }
+
+
+    #--- fastapi
+    #--- WARN: the below combined OR directive does not work
+    #location ~ ^/(api|fastapi|api2|fastapi2)/
+    location /api/ {
+        proxy_pass http://127.0.0.1:39132/;                      #--- default fastapi landing page
+        proxy_buffering off;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-Host $host;
+        proxy_set_header X-Forwarded-Port $server_port;
+    }
+    location ~ ^/(fastapi|api2|fastapi2)/ {
+        rewrite ^/fastapi/(.*) /api/$1 last;
+        rewrite ^/api2/(.*) /api/$1 last;
+        rewrite ^/fastapi2/(.*) /api/$1 last;
+        return 403; 
+    }
+
+    #--- gradio
+    location /gradio/ {
+        proxy_pass http://127.0.0.1:39133/;                      #--- default gradio landing page
+        proxy_buffering off;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-Host $host;
+        proxy_set_header X-Forwarded-Port $server_port;
+    }
+
+    #location /admin/nginx/ {
+    #    #rewrite ^(/download/.*)/media/(\w+)\.?.*$ $1/mp3/$2.mp3 last;
+    #    #return 403;
+    #
+    #    root   /usr/share/nginx/html;
+    #    index  index.html index.htm;
+    #}
+
+    #error_page  404              /404.html;
+
+    # redirect server error pages to the static page /50x.html
+    #
+    error_page   500 502 503 504  /50x.html;
+    location = /50x.html {
+        root   /usr/share/nginx/html;
+    }
+
+    # proxy the PHP scripts to Apache listening on 127.0.0.1:80
+    #
+    #location ~ \.php$ {
+    #    proxy_pass   http://127.0.0.1;
+    #}
+
+    # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
+    #
+    #location ~ \.php$ {
+    #    root           html;
+    #    fastcgi_pass   127.0.0.1:9000;
+    #    fastcgi_index  index.php;
+    #    fastcgi_param  SCRIPT_FILENAME  /scripts$fastcgi_script_name;
+    #    include        fastcgi_params;
+    #}
+
+    # deny access to .htaccess files, if Apache's document root
+    # concurs with nginx's one
+    #
+    #location ~ /\.ht {
+    #    deny  all;
+    #}
+}
+

nginx/etc.nginx.sites-available.default

@@ -0,0 +1,91 @@
+##
+# You should look at the following URL's in order to grasp a solid understanding
+# of Nginx configuration files in order to fully unleash the power of Nginx.
+# https://www.nginx.com/resources/wiki/start/
+# https://www.nginx.com/resources/wiki/start/topics/tutorials/config_pitfalls/
+# https://wiki.debian.org/Nginx/DirectoryStructure
+#
+# In most cases, administrators will remove this file from sites-enabled/ and
+# leave it as reference inside of sites-available where it will continue to be
+# updated by the nginx packaging team.
+#
+# This file will automatically load configuration files provided by other
+# applications, such as Drupal or Wordpress. These applications will be made
+# available underneath a path with that package name, such as /drupal8.
+#
+# Please see /usr/share/doc/nginx-doc/examples/ for more detailed examples.
+##
+
+# Default server configuration
+#
+server {
+	listen 80 default_server;
+	#listen [::]:80 default_server;								#--- IM:  disable ipv6 dependency
+
+	# SSL configuration
+	#
+	# listen 443 ssl default_server;
+	# listen [::]:443 ssl default_server;
+	#
+	# Note: You should disable gzip for SSL traffic.
+	# See: https://bugs.debian.org/773332
+	#
+	# Read up on ssl_ciphers to ensure a secure configuration.
+	# See: https://bugs.debian.org/765782
+	#
+	# Self signed certs generated by the ssl-cert package
+	# Don't use them in a production server!
+	#
+	# include snippets/snakeoil.conf;
+
+	root /var/www/html;
+
+	# Add index.php to the list if you are using PHP
+	index index.html index.htm index.nginx-debian.html;
+
+	server_name _;
+
+	location / {
+		# First attempt to serve request as file, then
+		# as directory, then fall back to displaying a 404.
+		try_files $uri $uri/ =404;
+	}
+
+	# pass PHP scripts to FastCGI server
+	#
+	#location ~ \.php$ {
+	#	include snippets/fastcgi-php.conf;
+	#
+	#	# With php-fpm (or other unix sockets):
+	#	fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
+	#	# With php-cgi (or other tcp sockets):
+	#	fastcgi_pass 127.0.0.1:9000;
+	#}
+
+	# deny access to .htaccess files, if Apache's document root
+	# concurs with nginx's one
+	#
+	#location ~ /\.ht {
+	#	deny all;
+	#}
+}
+
+
+# Virtual Host configuration for example.com
+#
+# You can move that to a different file under sites-available/ and symlink that
+# to sites-enabled/ to enable it.
+#
+#server {
+#	listen 80;
+#	listen [::]:80;
+#
+#	server_name example.com;
+#
+#	root /var/www/example.com;
+#	index index.html;
+#
+#	location / {
+#		try_files $uri $uri/ =404;
+#	}
+#}

nginx/etc.nginx_nginx.conf

@@ -0,0 +1,86 @@
+#--- 20240627:  remove user directive in attempt to get nginx to run alognside streamlit and fastapi
+#user www-data;
+worker_processes auto;
+pid /run/nginx.pid;
+include /etc/nginx/modules-enabled/*.conf;
+
+events {
+	worker_connections 768;
+	# multi_accept on;
+}
+
+http {
+
+	##
+	# Basic Settings
+	##
+
+	sendfile on;
+	tcp_nopush on;
+	tcp_nodelay on;
+	keepalive_timeout 65;
+	types_hash_max_size 2048;
+	# server_tokens off;
+
+	# server_names_hash_bucket_size 64;
+	# server_name_in_redirect off;
+
+	include /etc/nginx/mime.types;
+	default_type application/octet-stream;
+
+	##
+	# SSL Settings
+	##
+
+	ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3; # Dropping SSLv3, ref: POODLE
+	ssl_prefer_server_ciphers on;
+
+	##
+	# Logging Settings
+	##
+
+	access_log /var/log/nginx/access.log;
+	error_log /var/log/nginx/error.log;
+
+	##
+	# Gzip Settings
+	##
+
+	gzip on;
+
+	# gzip_vary on;
+	# gzip_proxied any;
+	# gzip_comp_level 6;
+	# gzip_buffers 16 8k;
+	# gzip_http_version 1.1;
+	# gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
+
+	##
+	# Virtual Host Configs
+	##
+
+	include /etc/nginx/conf.d/*.conf;									#--- IM:  check what *.conf files exist here
+	#include /etc/nginx/sites-enabled/*;								#--- IM:  do not include these virtual sites;  port 80 creates a problem
+}
+
+
+#mail {
+#	# See sample authentication script at:
+#	# http://wiki.nginx.org/ImapAuthenticateWithApachePhpScript
+# 
+#	# auth_http localhost/auth.php;
+#	# pop3_capabilities "TOP" "USER";
+#	# imap_capabilities "IMAP4rev1" "UIDPLUS";
+# 
+#	server {
+#		listen     localhost:110;
+#		protocol   pop3;
+#		proxy      on;
+#	}
+# 
+#	server {
+#		listen     localhost:143;
+#		protocol   imap;
+#		proxy      on;
+#	}
+#}

requirements.txt

@@ -0,0 +1,111 @@
+
+fastapi==0.111.0
+gradio==4.37.2
+shiny==0.10.2
+streamlit==1.36.0
+uvicorn==0.30.1
+
+#--- 20240716:  pip list on docker
+#Package                   Version
+#------------------------- -----------
+#aiofiles                  23.2.1
+#altair                    5.3.0
+#annotated-types           0.7.0
+#anyio                     4.4.0
+#appdirs                   1.4.4
+# asgiref                   3.8.1
+# attrs                     23.2.0
+# blinker                   1.8.2
+# cachetools                5.3.3
+# certifi                   2024.7.4
+# charset-normalizer        3.3.2
+# click                     8.1.7
+# contourpy                 1.1.1
+# cycler                    0.12.1
+# dnspython                 2.6.1
+# email_validator           2.2.0
+# exceptiongroup            1.2.1
+# fastapi                   0.111.0
+# fastapi-cli               0.0.4
+# ffmpy                     0.3.2
+# filelock                  3.15.4
+# fonttools                 4.53.1
+# fsspec                    2024.6.1
+# gitdb                     4.0.11
+# GitPython                 3.1.43
+# gradio                    4.37.2
+# gradio_client             1.0.2
+# h11                       0.14.0
+# htmltools                 0.5.2
+# httpcore                  1.0.5
+# httptools                 0.6.1
+# httpx                     0.27.0
+# huggingface-hub           0.23.4
+# idna                      3.7
+# importlib_resources       6.4.0
+# Jinja2                    3.1.4
+# jsonschema                4.23.0
+# jsonschema-specifications 2023.12.1
+# kiwisolver                1.4.5
+# linkify-it-py             2.0.3
+# markdown-it-py            3.0.0
+# MarkupSafe                2.1.5
+# matplotlib                3.7.5
+# mdit-py-plugins           0.4.1
+# mdurl                     0.1.2
+# numpy                     1.24.4
+# orjson                    3.10.6
+# packaging                 24.1
+# pandas                    2.0.3
+# pillow                    10.4.0
+# pip                       23.0.1
+# pkgutil_resolve_name      1.3.10
+# prompt-toolkit            3.0.36
+# protobuf                  5.27.2
+# pyarrow                   16.1.0
+# pydantic                  2.8.2
+# pydantic_core             2.20.1
+# pydeck                    0.9.1
+# pydub                     0.25.1
+# Pygments                  2.18.0
+# pyparsing                 3.1.2
+# python-dateutil           2.9.0.post0
+# python-dotenv             1.0.1
+# python-multipart          0.0.9
+# pytz                      2024.1
+# PyYAML                    6.0.1
+# questionary               2.0.1
+# referencing               0.35.1
+# requests                  2.32.3
+# rich                      13.7.1
+# rpds-py                   0.19.0
+# ruff                      0.5.1
+# semantic-version          2.10.0
+# setuptools                57.5.0
+# shellingham               1.5.4
+# shiny                     0.10.2
+# six                       1.16.0
+# smmap                     5.0.1
+# sniffio                   1.3.1
+# starlette                 0.37.2
+# streamlit                 1.36.0
+# tenacity                  8.5.0
+# toml                      0.10.2
+# tomlkit                   0.12.0
+# toolz                     0.12.1
+# tornado                   6.4.1
+# tqdm                      4.66.4
+# typer                     0.12.3
+# typing_extensions         4.12.2
+# tzdata                    2024.1
+# uc-micro-py               1.0.3
+# ujson                     5.10.0
+# urllib3                   2.2.2
+# uvicorn                   0.30.1
+# uvloop                    0.19.0
+# watchdog                  4.0.1
+# watchfiles                0.22.0
+# wcwidth                   0.2.13
+# websockets                11.0.3
+# wheel                     0.40.0
+# zipp                      3.19.2

streamlit/ABOUTME.md

@@ -0,0 +1,6 @@
+#   ABOUTME:  streamlit
+##      Purpose:    this environment is used to host a streamlit UI
+##      Prereq:     
+##      - 
+
+

streamlit/entry_streamlit.py

@@ -0,0 +1,23 @@
+'''
+    toExecute:  (from root app folder) ... streamlit run entry_streamlit.py
+'''
+import streamlit as st
+#import uix.lit_sidebar as litSideBar
+
+
+#--- streamlit:  specify title and logo
+st.set_page_config(
+            page_title='Protoype - Fastapi with Streamlit Landing Page', 
+            #page_icon='https://cdn.freebiesupply.com/logos/thumbs/1x/nvidia-logo.png', 
+            layout="wide")
+st.header('\
+    Protoyping Fastapi and Streamlit \
+    on Docker \
+    within Huggingface space \
+')
+#st.markdown("##### Iain McKone (Deployment Lead) [LinkedIn](%s)" % "https://linkedin.com/in/iainmckone")
+st.markdown('---')
+
+
+#--- streamlit:  add a sidebar 
+#litSideBar.init()