docs: :memo: Update docker requirements and other doc files

.gitignore

@@ -1,4 +1,6 @@
+.env
 .venv/
-uv.lock
-
-**__pycache__/
+.vscode/
+.cache/
+resources/
+**/__pycache__/

Dockerfile

@@ -9,13 +9,29 @@ RUN apt-get update && apt-get install -y \
     git \
     && rm -rf /var/lib/apt/lists/*
 
-# Set cache in /tmp (recommended in Spaces)
-ENV HF_HOME=/tmp/huggingface
+# Create cache directory and set permissions
+RUN mkdir -p /app/.cache/torch && \
+    chmod -R 777 /app/.cache
+
+# Set environment variables
+ENV TORCH_HOME=/app/.cache/torch \
+    ENABLE_XSRF_PROTECTION=false
+
+# Add a non-root user and switch to it
+RUN useradd -m -u 1000 appuser
+USER appuser
+ENV HOME="/home/appuser"
+WORKDIR $HOME
+
+RUN mkdir -p $HOME/.cache/torch && chmod -R 777 $HOME/.cache
+ENV TORCH_HOME=$HOME/.cache/torch
 
 COPY requirements.txt ./
 COPY src/ ./src/
+COPY embeddings/ ./embeddings/
 
-RUN pip3 install -r requirements.txt
+RUN pip3 install --user -r requirements.txt
+ENV PATH=$HOME/.local/bin:$PATH
 
 EXPOSE 8501
 

MakeFile

@@ -0,0 +1,43 @@
+# Python environment
+PROJECT_ROOT = $(shell pwd)
+VENV = $(PROJECT_ROOT)/.venv
+PYTHON_ENV = $(VENV)/bin/python
+
+# Docker image and container names for the student demo
+IMAGE_NAME = streamlit-student-demo
+CONTAINER_NAME = streamlit-student-demo-container
+PORT = 8501
+
+.PHONY: build run run-detached stop clean up restart
+
+# Build the Docker image using Dockerfile.simple
+build:
+	docker build -f Dockerfile.simple -t $(IMAGE_NAME) .
+
+# Run the Docker container interactively (foreground)
+run:
+	docker run --rm -it \
+		--name $(CONTAINER_NAME) \
+		-p $(PORT):8501 \
+		$(IMAGE_NAME)
+
+# Run the Docker container in detached mode (background)
+run-detached:
+	docker run -d \
+		--name $(CONTAINER_NAME) \
+		-p $(PORT):8501 \
+		$(IMAGE_NAME)
+
+# Stop the running container
+stop:
+	docker stop $(CONTAINER_NAME) || true
+
+# Remove the container (if stopped)
+clean:
+	docker rm $(CONTAINER_NAME) || true
+
+# Build and run in one command (detached)
+up: build run-detached
+
+# Stop, remove, rebuild, and run
+restart: stop clean up

pyproject.toml

@@ -1,13 +0,0 @@
-[project]
-name = "pokedex"
-version = "0.1.0"
-description = "Add your description here"
-readme = "README.md"
-requires-python = "==3.11.*"
-dependencies = [
-    "pillow",
-    "requests",
-    "streamlit",
-    "torch",
-    "transformers",
-]

requirements.txt

@@ -1,5 +1,12 @@
-pillow
-requests
-streamlit
-torch
+numpy==1.26.4
+packaging==23.2
+setuptools==69.2.0
+fastapi==0.109.2
+uvicorn==0.27.1
+python-multipart==0.0.9
+requests==2.31.0
+torch==2.2.1
+torchvision==0.17.1
+Pillow==10.2.0
+streamlit==1.32.0 
 transformers

src/streamlit_app.py

@@ -1,11 +1,3 @@
-import os
-# Define temporal path for fixing issues
-os.environ['HF_HOME'] = '/tmp/huggingface'
-
-# Create the path if it doesn't exists
-os.makedirs('/tmp/huggingface', exist_ok=True)
-
-
 import streamlit as st
 from PIL import Image
 from similarity import PokemonSimilarity