Update README.md
Browse files
README.md
CHANGED
|
@@ -15,7 +15,7 @@ tags:
|
|
| 15 |
|
| 16 |
# ๐ฎ Steam Game Recommendations
|
| 17 |
|
| 18 |
-
|
| 19 |
|
| 20 |
## ๐ฅ Demo Video
|
| 21 |
|
|
@@ -25,8 +25,6 @@ An AI-powered chatbot that provides personalized Steam game recommendations usin
|
|
| 25 |
|
| 26 |
[LinkedIn Post](https://www.linkedin.com/posts/gustav-m-15802b102_steam-game-recommendations-a-hugging-face-share-7400915284620132355-hBi6?utm_source=share&utm_medium=member_desktop&rcm=ACoAABn9DRQBDi9mKnBPkKI-q9OlhEh9zK9Bbfc)
|
| 27 |
|
| 28 |
-
**Note:** You must include a link to your social media post (X/Twitter, LinkedIn, etc.) about your project to qualify for prizes. You can publish your app on social media anytime from Nov 14-30, 2025.
|
| 29 |
-
|
| 30 |
## โจ Features
|
| 31 |
|
| 32 |
- **Personalized Greetings**: AI-generated greetings based on your last played game and playtime
|
|
@@ -66,7 +64,7 @@ An AI-powered chatbot that provides personalized Steam game recommendations usin
|
|
| 66 |
OLLAMA_HOST=localhost:11434 # Optional: specify Ollama host
|
| 67 |
|
| 68 |
# For Hugging Face Inference API (fallback when Ollama unavailable)
|
| 69 |
-
HF_MODEL=mistralai/
|
| 70 |
HF_TOKEN=your_hf_token # Optional: for private models or higher rate limits
|
| 71 |
```
|
| 72 |
|
|
@@ -144,7 +142,7 @@ The app automatically tries Ollama first, then falls back to Hugging Face Infere
|
|
| 144 |
|
| 145 |
### Ollama Models
|
| 146 |
|
| 147 |
-
The default model is `qwen2.5:7b
|
| 148 |
- `qwen2.5:7b` (default) - Excellent instruction following and balance
|
| 149 |
- `llama3` - Excellent instruction following
|
| 150 |
- `qwen2.5:14b` - Better quality, requires more resources
|
|
@@ -180,7 +178,6 @@ All API calls and responses are visible in real-time for compliance and transpar
|
|
| 180 |
- **AI Model Required**: The chatbot requires either Ollama (local) or Hugging Face Inference API (cloud) for AI responses. Hugging Face Inference API is automatically used as a fallback when Ollama is not available (e.g., on Hugging Face Spaces).
|
| 181 |
- **Hugging Face Token**: On Hugging Face Spaces, you need to add your Hugging Face token as a secret named `HF_TOKEN` in your Space settings (Settings โ Variables and secrets). Get your token at https://huggingface.co/settings/tokens
|
| 182 |
- **API Key**: Enter your Steam Web API key directly in the form - no .env file needed
|
| 183 |
-
- **Genre Filtering**: When you request games excluding genres (e.g., "not horror"), the system fetches genre data from Steam Store API and filters games accordingly
|
| 184 |
- **API Transparency**: All API calls and responses are displayed in real-time in the API results panel for full transparency and Steam API compliance
|
| 185 |
|
| 186 |
## ๐ Resources
|
|
@@ -195,17 +192,8 @@ All API calls and responses are visible in real-time for compliance and transpar
|
|
| 195 |
|
| 196 |
This project is part of **MCP's 1st Birthday Hackathon** hosted by Anthropic and Gradio.
|
| 197 |
|
| 198 |
-
**To qualify for prizes, you MUST:**
|
| 199 |
-
- โ
Be a member of the [MCP-1st-Birthday organization](https://huggingface.co/MCP-1st-Birthday)
|
| 200 |
-
- โ
Submit your app to the organization
|
| 201 |
-
- โ
Include appropriate track tags in your Space README (โ
Done: `building-mcp-track-steam-chatbot`)
|
| 202 |
-
- โ
Include a link to your social media post about your project (โ ๏ธ Add above)
|
| 203 |
-
- โ
Submit by **November 30, 2025, 11:59 PM UTC**
|
| 204 |
-
|
| 205 |
**Track:** Building MCP (Track 1)
|
| 206 |
|
| 207 |
-
**Join the Discord:** `agents-mcp-hackathon-winter25๐` for latest information and support.
|
| 208 |
-
|
| 209 |
---
|
| 210 |
|
| 211 |
**Note:** This project was created as part of the MCP's 1st Birthday Hackathon (Nov 14-30, 2025). Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
|
|
|
|
| 15 |
|
| 16 |
# ๐ฎ Steam Game Recommendations
|
| 17 |
|
| 18 |
+
Chatbot that provides personalized Steam game recommendations using the Steam Web API and AI models (Ollama or Hugging Face Inference API) for natural language interactions.
|
| 19 |
|
| 20 |
## ๐ฅ Demo Video
|
| 21 |
|
|
|
|
| 25 |
|
| 26 |
[LinkedIn Post](https://www.linkedin.com/posts/gustav-m-15802b102_steam-game-recommendations-a-hugging-face-share-7400915284620132355-hBi6?utm_source=share&utm_medium=member_desktop&rcm=ACoAABn9DRQBDi9mKnBPkKI-q9OlhEh9zK9Bbfc)
|
| 27 |
|
|
|
|
|
|
|
| 28 |
## โจ Features
|
| 29 |
|
| 30 |
- **Personalized Greetings**: AI-generated greetings based on your last played game and playtime
|
|
|
|
| 64 |
OLLAMA_HOST=localhost:11434 # Optional: specify Ollama host
|
| 65 |
|
| 66 |
# For Hugging Face Inference API (fallback when Ollama unavailable)
|
| 67 |
+
HF_MODEL=mistralai/Qwen/Qwen2.5-7B-Instruct # Optional: specify HF model
|
| 68 |
HF_TOKEN=your_hf_token # Optional: for private models or higher rate limits
|
| 69 |
```
|
| 70 |
|
|
|
|
| 142 |
|
| 143 |
### Ollama Models
|
| 144 |
|
| 145 |
+
The default model is `qwen2.5:7b`. You can also use other models like:
|
| 146 |
- `qwen2.5:7b` (default) - Excellent instruction following and balance
|
| 147 |
- `llama3` - Excellent instruction following
|
| 148 |
- `qwen2.5:14b` - Better quality, requires more resources
|
|
|
|
| 178 |
- **AI Model Required**: The chatbot requires either Ollama (local) or Hugging Face Inference API (cloud) for AI responses. Hugging Face Inference API is automatically used as a fallback when Ollama is not available (e.g., on Hugging Face Spaces).
|
| 179 |
- **Hugging Face Token**: On Hugging Face Spaces, you need to add your Hugging Face token as a secret named `HF_TOKEN` in your Space settings (Settings โ Variables and secrets). Get your token at https://huggingface.co/settings/tokens
|
| 180 |
- **API Key**: Enter your Steam Web API key directly in the form - no .env file needed
|
|
|
|
| 181 |
- **API Transparency**: All API calls and responses are displayed in real-time in the API results panel for full transparency and Steam API compliance
|
| 182 |
|
| 183 |
## ๐ Resources
|
|
|
|
| 192 |
|
| 193 |
This project is part of **MCP's 1st Birthday Hackathon** hosted by Anthropic and Gradio.
|
| 194 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 195 |
**Track:** Building MCP (Track 1)
|
| 196 |
|
|
|
|
|
|
|
| 197 |
---
|
| 198 |
|
| 199 |
**Note:** This project was created as part of the MCP's 1st Birthday Hackathon (Nov 14-30, 2025). Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
|