🏠 100% Local: Run GPT-OSS on your own hardware using Ollama
🧠 See The Thinking: Watch the model's reasoning process unfold in expandable panels
🔒 Privacy First: Your conversations never leave your machine
⚡ GPT-OSS:20B: Advanced reasoning capabilities with native thinking support
💰 Zero Cost: No API fees or usage limits

Key Features

Thinking UI: Expandable panels show model's reasoning process
Real-time Streaming: See responses generate as the model thinks
Chat History: Full conversation history with thinking processes preserved
Clean Interface: Professional UI with OpenAI and Ollama logos

Installation and Setup

Prerequisites

Python 3.12 or later
uv (recommended) or pip

1. Setup Ollama

# Install Ollama (Linux/macOS)
curl -fsSL https://ollama.com/install.sh | sh

# Pull the GPT-OSS model
ollama pull gpt-oss:20b

2. Install Dependencies

Using uv (recommended):

uv sync

Using pip:

pip install streamlit ollama

3. Run the App

uv run streamlit run app.py
# or with pip: streamlit run app.py

The app will be available at http://localhost:8501 (or 8502 if 8501 is busy).

Get a FREE Data Science eBook 📖 with 150+ essential lessons in Data Science when you subscribe to our newsletter! Stay in the loop with the latest tutorials, insights, and exclusive resources. Subscribe now!

Contribution

Contributions are welcome! Please fork the repository and submit a pull request with your improvements.

README.md

Run GPT-OSS Locally with Thinking UI 🧠

Why This Matters