Inital upload of working files

.dockerignore

@@ -0,0 +1,20 @@
+# Prevent secrets and junk from being baked into Docker images
+
+# Secrets
+.env
+.env.*
+
+# macOS junk
+.DS_Store
+
+# Python cache
+__pycache__/
+*.py[cod]
+
+# Virtual environments
+.venv/
+venv/
+
+# Git stuff (optional)
+.git
+.gitignore

.env.sample

@@ -0,0 +1 @@
+OPENAI_API_KEY=###

.gitignore

@@ -0,0 +1,164 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# more stuff Leo
+.DS_Store
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+.chainlit/
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/

Dockerfile

@@ -0,0 +1,42 @@
+# Get a distribution that has uv already installed
+FROM ghcr.io/astral-sh/uv:python3.13-bookworm-slim
+
+# Add Rust compiler installation
+USER root
+RUN apt-get update && apt-get install -y \
+    curl \
+    build-essential \
+    && rm -rf /var/lib/apt/lists/*
+RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
+ENV PATH="/root/.cargo/bin:${PATH}"
+
+# Add user - this is the user that will run the app
+# If you do not set user, the app will run as root (undesirable)
+RUN useradd -m -u 1000 user
+USER user
+
+# Set up Rust for the user
+RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
+ENV PATH="/home/user/.cargo/bin:${PATH}"
+
+# Set the home directory and path
+ENV HOME=/home/user \
+    PATH=/home/user/.local/bin:$PATH        
+
+ENV UVICORN_WS_PROTOCOL=websockets
+
+# Set the working directory
+WORKDIR $HOME/app
+
+# Copy the app to the container
+COPY --chown=user . $HOME/app
+
+# Install the dependencies
+# RUN uv sync --frozen
+RUN uv sync
+
+# Expose the port
+EXPOSE 7860
+
+# Run the app
+CMD ["uv", "run", "chainlit", "run", "app.py", "--host", "0.0.0.0", "--port", "7860"]

README.md

@@ -1,12 +1,73 @@
 ---
-title: Llm2
-emoji: 😻
-colorFrom: green
-colorTo: pink
+title: Beyond ChatGPT – Beginner LLM App
+emoji: 💬
+colorFrom: blue
+colorTo: indigo
 sdk: docker
-pinned: false
-license: openrail
-short_description: 'LLM-based chatbot based on AIMakerspace tutorial '
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 💬 Beyond ChatGPT – Beginner LLM App
+
+This is a simple LLM-based chatbot built during the **Beyond ChatGPT** tutorial from [AI Makerspace](https://github.com/AI-Maker-Space/Beyond-ChatGPT).  
+It runs locally or in a Hugging Face Space using Docker.
+
+The app connects to the OpenAI API and supports system messages, few-shot prompting, and chain-of-thought-style reasoning — all within a clean conversational UI.
+
+---
+
+## 🧠 What You Can Do
+
+- Send prompts to a live OpenAI model
+- Test structured prompting techniques
+- Explore different system/assistant/user message configurations
+- Use this app as a foundation for building your own LLM tools
+
+---
+
+## 🚀 How to Use
+
+If running on Hugging Face (or locally via Docker):
+
+1. Enter a prompt in the chat window
+2. Press `Enter` or click `Send`
+3. The model will respond in a conversational format
+
+---
+
+## 🔧 Tech Stack
+
+- Python
+- OpenAI API (`gpt-3.5-turbo` or similar)
+- Chainlit (chat interface)
+- Docker (for deployment)
+- Hugging Face Spaces (hosted version)
+
+---
+
+## 📦 Tutorial Origin
+
+This app was built as part of the *Beyond ChatGPT* tutorial by AI Makerspace:  
+🔗 https://github.com/AI-Maker-Space/Beyond-ChatGPT
+
+---
+
+## ⚠️ Notes
+
+- You’ll need a valid OpenAI API key to run this locally or deploy it to Hugging Face.
+- If using Docker, the app runs on port 7860 by default.
+
+---
+
+## 🧪 Example Prompt
+
+```
+What are the key takeaways from the book "Thinking, Fast and Slow"?
+```
+
+---
+
+## 🙌 Credits
+
+Thanks to the team at AI Makerspace for the tutorial and code scaffold.
+
+---

app.py

@@ -0,0 +1,94 @@
+# You can find this code for Chainlit python streaming here (https://docs.chainlit.io/concepts/streaming/python)
+
+# OpenAI Chat completion
+import os
+from openai import AsyncOpenAI  # importing openai for API usage
+import chainlit as cl  # importing chainlit for our app
+from chainlit.prompt import Prompt, PromptMessage  # importing prompt tools
+from chainlit.playground.providers import ChatOpenAI  # importing ChatOpenAI tools
+from dotenv import load_dotenv
+
+load_dotenv()
+
+# ChatOpenAI Templates
+system_template = """You are a helpful assistant who always speaks in a pleasant tone!
+"""
+
+user_template = """{input}
+Think through your response step by step.
+"""
+
+
+@cl.on_chat_start  # marks a function that will be executed at the start of a user session
+async def start_chat():
+    settings = {
+        "model": "gpt-3.5-turbo",
+        "temperature": 0,
+        "max_tokens": 500,
+        "top_p": 1,
+        "frequency_penalty": 0,
+        "presence_penalty": 0,
+    }
+
+    cl.user_session.set("settings", settings)
+
+
+@cl.on_message  # marks a function that should be run each time the chatbot receives a message from a user
+async def main(message: cl.Message):
+    settings = cl.user_session.get("settings")
+   
+    # Increment message count
+    max_messages = 3
+    count = cl.user_session.get("message_count") or 0
+    count += 1
+    cl.user_session.set("message_count", count)
+
+    # Stop after 3 messages
+    if count > max_messages:
+        await cl.Message(
+            content="⚠️ This demo is limited to 3 messages per session."
+        ).send()
+        return
+
+    client = AsyncOpenAI()
+
+
+    print(message.content)
+
+    prompt = Prompt(
+        provider=ChatOpenAI.id,
+        messages=[
+            PromptMessage(
+                role="system",
+                template=system_template,
+                formatted=system_template,
+            ),
+            PromptMessage(
+                role="user",
+                template=user_template,
+                formatted=user_template.format(input=message.content),
+            ),
+        ],
+        inputs={"input": message.content},
+        settings=settings,
+    )
+
+    print([m.to_openai() for m in prompt.messages])
+
+    msg = cl.Message(content="")
+
+    # Call OpenAI
+    async for stream_resp in await client.chat.completions.create(
+        messages=[m.to_openai() for m in prompt.messages], stream=True, **settings
+    ):
+        token = stream_resp.choices[0].delta.content
+        if not token:
+            token = ""
+        await msg.stream_token(token)
+
+    # Update the prompt object with the completion
+    prompt.completion = msg.content
+    msg.prompt = prompt
+
+    # Send and close the message stream
+    await msg.send()

chainlit.md

@@ -0,0 +1,13 @@
+# 👋 Welcome to Beyond ChatGPT – Beginner LLM App
+
+This lightweight assistant was built using [Chainlit](https://www.chainlit.io/) and OpenAI, as part of the #AI_Makerspace tutorial series.
+
+💬 You can type in any question or prompt to get a thoughtful reply.
+
+⚠️ For demo purposes, responses are limited to **3 messages per session**.
+
+---
+
+🔧 Want to learn how this was built?  
+Check out the source code and deployment steps in the project [README](https://huggingface.co/spaces/FlamingNeuron/llm-app/tree/main).
+

pyproject.toml

@@ -0,0 +1,14 @@
+[project]
+name = "beyond-chatgpt"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "chainlit==0.7.700",
+    "cohere==4.37",
+    "openai==1.3.5",
+    "pydantic==2.10.1",
+    "python-dotenv==1.0.0",
+    "tiktoken==0.5.1",
+]