ngebodh commited on
Commit
abcb84e
Β·
verified Β·
1 Parent(s): 8e9a30e

Updated Readme

Browse files
Files changed (1) hide show
  1. README.md +95 -2
README.md CHANGED
@@ -1,6 +1,6 @@
1
  ---
2
  title: SimpleChatbot
3
- emoji: πŸ“Š
4
  colorFrom: purple
5
  colorTo: pink
6
  sdk: streamlit
@@ -8,6 +8,99 @@ sdk_version: 1.31.1
8
  app_file: app.py
9
  pinned: false
10
  license: mit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
11
  ---
12
 
13
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
  title: SimpleChatbot
3
+ emoji: πŸ€–
4
  colorFrom: purple
5
  colorTo: pink
6
  sdk: streamlit
 
8
  app_file: app.py
9
  pinned: false
10
  license: mit
11
+ models:
12
+ - openai/gpt-oss-120b
13
+ - mistralai/Mistral-7B-Instruct-v0.2
14
+ - google/gemma-3-27b-it
15
+ - google/gemma-2-27b-it
16
+ - google/gemma-2-9b-it
17
+ - google/gemma-2-2b-it
18
+ - HuggingFaceH4/zephyr-7b-gemma-v0.1
19
+ - HuggingFaceH4/zephyr-7b-beta
20
+ - meta-llama/Meta-Llama-3-8B-Instruct
21
+ - meta-llama/Meta-Llama-3.1-8B-Instruct
22
+ - deepseek-ai/DeepSeek-R1-Distill-Llama-70B
23
+ - Qwen/Qwen2.5-Coder-32B-Instruct
24
+ - moonshotai/Kimi-K2-Instruct
25
+
26
+ ---
27
+
28
+ # πŸ€– SimpleChatbot
29
+
30
+ [![Streamlit](https://img.shields.io/badge/Built%20with-Streamlit-FF4B4B?logo=streamlit&logoColor=white)](https://streamlit.io/)
31
+ [![Hugging Face Space](https://img.shields.io/badge/Hugging%20Face-Space-yellow?logo=huggingface)](https://huggingface.co/spaces)
32
+ [![Python](https://img.shields.io/badge/Python-3.9%2B-blue?logo=python&logoColor=white)](https://www.python.org/)
33
+ [![Open Source](https://img.shields.io/badge/Open%20Source-Yes-green)]()
34
+
35
+ **SimpleChatbot** is a lightweight Streamlit app that lets you chat with multiple large language models (LLMs) from a single interface. It’s built as a simple, interactive way to explore and compare different models without switching tools or setups.
36
+
37
+ ---
38
+
39
+ ## ✨ Features
40
+
41
+ - Chat with **multiple LLMs** from one UI
42
+ - Switch models on the fly (conversation resets automatically)
43
+ - Adjustable **temperature** for response creativity
44
+ - Built-in **rate limiting & cooldowns** for fair usage
45
+ - Optional **Hugging Face access token** support
46
+ - Session-based logging and usage tracking
47
+ - Clean, minimal Streamlit interface
48
+
49
+ ---
50
+
51
+ ## 🧠 Supported Models
52
+
53
+ This app supports a mix of general-purpose, reasoning, and coding-focused models, including:
54
+
55
+ - OpenAI GPT-OSS-120B
56
+ - Meta Llama 3 / 3.1
57
+ - Google Gemma (2 & 3 series)
58
+ - DeepSeek R1 (distilled)
59
+ - Qwen 2.5 Coder
60
+ - Kimi-K2 Instruct
61
+ - Zephyr & Mistral variants
62
+
63
+ > Available models may change depending on backend availability.
64
+
65
+ ---
66
+
67
+ ## 🎯 Why This Exists
68
+
69
+ This project was built to:
70
+
71
+ - **Quickly compare LLM behavior** across different model families
72
+ - Provide a **simple reference implementation** for multi-model chat apps
73
+ - Demonstrate how to build a Streamlit chatbot using modern inference APIs
74
+ - Serve as a lightweight demo for experimentation, education, and prototyping
75
+
76
+ It intentionally avoids complex agent logic or tooling to keep the focus on **model responses and UX**.
77
+
78
  ---
79
 
80
+ ## πŸš€ How to Use
81
+
82
+ 1. Select a **model client** in the sidebar
83
+ 2. Choose a **model**
84
+ 3. Adjust the **temperature** if desired
85
+ 4. Start chatting!
86
+
87
+ Responses are intentionally kept brief to keep interactions fast and readable.
88
+
89
+ ---
90
+
91
+ ## ⚠️ Notes
92
+
93
+ - Generated content may be **inaccurate or incorrect**
94
+ - API calls are limited per session to prevent abuse
95
+ - If a model fails, it may be temporarily unavailable or updating
96
+
97
+ ---
98
+
99
+ ## πŸ‘€ Author
100
+
101
+ Created by **Nigel Gebodh**
102
+ 🌐 https://ngebodh.github.io/
103
+
104
+ Learn how to build this chatbot yourself:
105
+ πŸ‘‰ https://ngebodh.github.io/projects/2024-03-05/
106
+