Spaces:
Sleeping
Sleeping
Commit
·
f17b06a
1
Parent(s):
42bd21b
README for HF
Browse files- readme.md +10 -61
- readme2.md +61 -0
readme.md
CHANGED
@@ -1,61 +1,10 @@
|
|
1 |
-
|
2 |
-
|
3 |
-
|
4 |
-
|
5 |
-
|
6 |
-
|
7 |
-
|
8 |
-
|
9 |
-
|
10 |
-
|
11 |
-
* **Streamlit:** Streamlit's intuitive and user-friendly interface allows for a smooth and engaging gameplay experience.
|
12 |
-
* **Ollama:** The large language model service Ollama, using the "Gemma2" model, generates cases and provides intelligent and realistic responses to the player's questions, creating an immersive interrogation experience.
|
13 |
-
|
14 |
-
**Requirements:**
|
15 |
-
|
16 |
-
* **Ollama:** The Ollama large language model service must be installed and running on its default port `11434`, and the `Gemma2` model should be downloaded.
|
17 |
-
|
18 |
-
**How to Play:**
|
19 |
-
1. Clone the repository:
|
20 |
-
```bash
|
21 |
-
git clone https://github.com/danielRamon/cluedo.git
|
22 |
-
```
|
23 |
-
2. Install the dependencies:
|
24 |
-
```bash
|
25 |
-
cd cluedo
|
26 |
-
pip install -r requirements.txt
|
27 |
-
```
|
28 |
-
3. Start the game:
|
29 |
-
```bash
|
30 |
-
streamlit run streamlit_app.py
|
31 |
-
```
|
32 |
-
|
33 |
-
4. Play
|
34 |
-
|
35 |
-

|
36 |
-

|
37 |
-
|
38 |
-
**Contributions:**
|
39 |
-
|
40 |
-
Contributions are welcome! You can help improve the game in the following ways:
|
41 |
-
|
42 |
-
* **AI Enhancement:** Explore ways to improve Ollama's ability to generate more natural and convincing responses, as well as using other LLM services.
|
43 |
-
* **New Features:** Implement new features such as a scoring system, multiple difficulty levels, or the ability to save and load games.
|
44 |
-
* **Create a Cloud Service:** You can deploy the game on a server so that others without technical knowledge can use it.
|
45 |
-
|
46 |
-
**Project Structure:**
|
47 |
-
|
48 |
-
* `streamlit_app.py`: The main file containing the game logic and the Streamlit user interface.
|
49 |
-
* `generate_players.py`: Auxiliary code for creating stories and characters at the start of the game.
|
50 |
-
* `resources`: Folder containing images for the end of the game.
|
51 |
-
* `requirements.txt`: File listing the project's dependencies.
|
52 |
-
|
53 |
-
**Notes:**
|
54 |
-
|
55 |
-
This project is intended for self-learning purposes, so any constructive feedback is welcome.
|
56 |
-
|
57 |
-
**Have fun solving crimes!**
|
58 |
-
|
59 |
-
**Daniel Ramón Gallardo**
|
60 |
-
|
61 |
-
**[LinkedIn](https://www.linkedin.com/in/daniel-ramon-gallardo/)**
|
|
|
1 |
+
---
|
2 |
+
title: Cluedo
|
3 |
+
emoji: 🕵️
|
4 |
+
colorFrom: gray
|
5 |
+
colorTo: green
|
6 |
+
sdk: streamlit
|
7 |
+
sdk_version: "1.37.1"
|
8 |
+
app_file: streamlit_app.py
|
9 |
+
pinned: false
|
10 |
+
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
readme2.md
ADDED
@@ -0,0 +1,61 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
## Cluedo
|
2 |
+
|
3 |
+
### Detective Game with Streamlit and Ollama: Solve the Crime
|
4 |
+
|
5 |
+
**Description:**
|
6 |
+
|
7 |
+
Dive into an exciting world of mystery and crime-solving! This interactive game puts you in the shoes of a clever detective who must unravel a case. Interrogate suspects and witnesses, analyze clues, and use all your intelligence to discover the culprit.
|
8 |
+
|
9 |
+
**Technologies:**
|
10 |
+
|
11 |
+
* **Streamlit:** Streamlit's intuitive and user-friendly interface allows for a smooth and engaging gameplay experience.
|
12 |
+
* **Ollama:** The large language model service Ollama, using the "Gemma2" model, generates cases and provides intelligent and realistic responses to the player's questions, creating an immersive interrogation experience.
|
13 |
+
|
14 |
+
**Requirements:**
|
15 |
+
|
16 |
+
* **Ollama:** The Ollama large language model service must be installed and running on its default port `11434`, and the `Gemma2` model should be downloaded.
|
17 |
+
|
18 |
+
**How to Play:**
|
19 |
+
1. Clone the repository:
|
20 |
+
```bash
|
21 |
+
git clone https://github.com/danielRamon/cluedo.git
|
22 |
+
```
|
23 |
+
2. Install the dependencies:
|
24 |
+
```bash
|
25 |
+
cd cluedo
|
26 |
+
pip install -r requirements.txt
|
27 |
+
```
|
28 |
+
3. Start the game:
|
29 |
+
```bash
|
30 |
+
streamlit run streamlit_app.py
|
31 |
+
```
|
32 |
+
|
33 |
+
4. Play
|
34 |
+
|
35 |
+

|
36 |
+

|
37 |
+
|
38 |
+
**Contributions:**
|
39 |
+
|
40 |
+
Contributions are welcome! You can help improve the game in the following ways:
|
41 |
+
|
42 |
+
* **AI Enhancement:** Explore ways to improve Ollama's ability to generate more natural and convincing responses, as well as using other LLM services.
|
43 |
+
* **New Features:** Implement new features such as a scoring system, multiple difficulty levels, or the ability to save and load games.
|
44 |
+
* **Create a Cloud Service:** You can deploy the game on a server so that others without technical knowledge can use it.
|
45 |
+
|
46 |
+
**Project Structure:**
|
47 |
+
|
48 |
+
* `streamlit_app.py`: The main file containing the game logic and the Streamlit user interface.
|
49 |
+
* `generate_players.py`: Auxiliary code for creating stories and characters at the start of the game.
|
50 |
+
* `resources`: Folder containing images for the end of the game.
|
51 |
+
* `requirements.txt`: File listing the project's dependencies.
|
52 |
+
|
53 |
+
**Notes:**
|
54 |
+
|
55 |
+
This project is intended for self-learning purposes, so any constructive feedback is welcome.
|
56 |
+
|
57 |
+
**Have fun solving crimes!**
|
58 |
+
|
59 |
+
**Daniel Ramón Gallardo**
|
60 |
+
|
61 |
+
**[LinkedIn](https://www.linkedin.com/in/daniel-ramon-gallardo/)**
|