danielRamon commited on
Commit
f17b06a
·
1 Parent(s): 42bd21b

README for HF

Browse files
Files changed (2) hide show
  1. readme.md +10 -61
  2. readme2.md +61 -0
readme.md CHANGED
@@ -1,61 +1,10 @@
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
- ![Intro](./resources/intro_readme.gif)
36
- ![Game](./resources/game_readme.gif)
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
+ ![Intro](./resources/intro_readme.gif)
36
+ ![Game](./resources/game_readme.gif)
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/)**