Initial commit

.gitignore

@@ -0,0 +1,6 @@
+__pycache__/
+.chainlit/
+.venv/ 
+.env
+.chainlit/
+.files/

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "data"]
+	path = data
+	url = [email protected]:mbudisic/PsTuts-VQA-Dataset.git

.python-version

@@ -0,0 +1 @@
+3.13

DEVELOPER.md

@@ -0,0 +1,50 @@
+# 🛠️ Developer Documentation
+
+## 📦 Project Structure
+
+```
+.
+├── app.py              # Main Chainlit application
+├── requirements.txt    # Project dependencies
+└── README.md          # User documentation
+```
+
+## 🔧 Technical Details
+
+The application uses Chainlit (v0.7.700+) to create a simple chat interface. The main functionality is implemented in `app.py` using the `@cl.on_message` decorator to handle incoming messages.
+
+### Key Components
+
+- `@cl.on_message`: Decorator that handles incoming messages from the chat interface
+- `cl.Message`: Class for creating and sending messages back to the user
+- Async/await pattern for handling message processing
+
+## 🚀 Running Locally
+
+1. Create a virtual environment (recommended):
+```bash
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+```
+
+2. Install dependencies:
+```bash
+pip install -r requirements.txt
+```
+
+3. Run the development server:
+```bash
+chainlit run app.py
+```
+
+## 🔍 Debugging
+
+- Chainlit provides a built-in debug mode. Run with:
+```bash
+chainlit run app.py --debug
+```
+
+## 📚 Resources
+
+- [Chainlit Documentation](https://docs.chainlit.io)
+- [Chainlit GitHub Repository](https://github.com/Chainlit/chainlit) 

Dockerfile

@@ -0,0 +1,31 @@
+
+# Get a distribution that has uv already installed
+FROM ghcr.io/astral-sh/uv:python3.13-bookworm-slim
+
+# 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 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

@@ -10,3 +10,26 @@ short_description: Agentic RAG that interrogates the PsTuts dataset.
 ---
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+# 🤖 Chainlit Hello World App
+
+A minimal Chainlit application that demonstrates basic chat functionality.
+
+## 🚀 Getting Started
+
+1. Install dependencies:
+```bash
+pip install -r requirements.txt
+```
+
+2. Run the app:
+```bash
+chainlit run app.py
+```
+
+3. Open your browser and navigate to `http://localhost:8000`
+
+## 💡 Features
+
+- Simple chat interface
+- Echo functionality that repeats back your messages

app.py

@@ -0,0 +1,12 @@
+import chainlit as cl
+
+@cl.on_message
+async def main(message: cl.Message):
+    # Send a response back to the user
+    await cl.Message(
+        content=f"Hello! You said: {message.content}"
+    ).send()
+
+
+if __name__ == "__main__":
+    main()

chainlit.md

@@ -0,0 +1,14 @@
+# Welcome to Chainlit! 🚀🤖
+
+Hi there, Developer! 👋 We're excited to have you on board. Chainlit is a powerful tool designed to help you prototype, debug and share applications built on top of LLMs.
+
+## Useful Links 🔗
+
+- **Documentation:** Get started with our comprehensive [Chainlit Documentation](https://docs.chainlit.io) 📚
+- **Discord Community:** Join our friendly [Chainlit Discord](https://discord.gg/k73SQ3FyUh) to ask questions, share your projects, and connect with other developers! 💬
+
+We can't wait to see what you create with Chainlit! Happy coding! 💻😊
+
+## Welcome screen
+
+To modify the welcome screen, edit the `chainlit.md` file at the root of your project. If you do not want a welcome screen, just leave this file empty.

data

@@ -0,0 +1 @@
+Subproject commit ae4b7cc721ad86ef2fe97e1a72a7fd7edb0703b7

pyproject.toml

@@ -0,0 +1,50 @@
+[project]
+name = "pstuts-rag"
+version = "2025.05.12"
+description = "Agentic RAG system for PsTuts dataset"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "aiohttp>=3.8.0",
+    "chainlit==2.0.4",
+    "dotenv>=0.9.9",
+    "easyocr>=1.7.2",
+    "fastapi>=0.115.3,<0.116",
+    "httpx==0.27.0",
+    "ipykernel>=6.29.5",
+    "ipywidgets>=8.1.7",
+    "jq>=1.8.0",
+    "jupyter>=1.1.1",
+    "langchain-community>=0.3.23",
+    "langchain-experimental>=0.3.4",
+    "langchain-openai",
+    "langchain-qdrant>=0.2.0",
+    "langchain>=0.3.25",
+    "langgraph>=0.4.3",
+    "numpy==2.2.2",
+    "openai==1.59.9",
+    "pip>=25.0.1",
+    "pydantic==2.10.1",
+    "pypdf2==3.0.1",
+    "python-multipart>=0.0.18,<0.0.19",
+    "ragas>=0.2.15",
+    "requests>=2.31.0",
+    "tavily-python>=0.7.2",
+    "tqdm",
+    "typing-extensions>=4.0.0",
+    "unstructured>=0.17.2",
+    "uvicorn>=0.25.0,<0.26.0",
+    "websockets==14.2",
+
+]
+authors = [
+    { name="Marko Budisic", email="[email protected]" }
+    ]
+license = "MIT"
+
+[build-system]
+requires = ["hatchling >= 1.26"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["pstuts-rag/pstuts-rag"]

requirements.txt

@@ -0,0 +1 @@
+chainlit>=0.7.700