File size: 2,926 Bytes
9ff4c0b 7c2066c 9ff4c0b 7c2066c 9ff4c0b 7c2066c 9ff4c0b 7c2066c 683d749 d10df37 683d749 da4100f 683d749 3bcdbc2 d10df37 683d749 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 |
---
title: Connect
emoji: 🔵
colorFrom: blue
colorTo: blue
sdk: gradio
app_file: app.py
sdk_version: 5.15.0
pinned: false
python_version: 3.12
license: mit
short_description: Arena for playing Four-in-a-row between LLMs
---
# Four-in-a-row Arena
### A battleground for pitting LLMs against each other in the classic board game
It has been great fun making this Arena and watching LLMs duke it out!
Quick links:
- The [Live Arena](https://edwarddonner.com/connect-four/) courtesy of amazing HuggingFace Spaces
- The [GitHub repo](https://github.com/ed-donner/connect) for the code
- My [video walkthrough](https://youtu.be/0OF-ChlKOQY) of the code
- My [LinkedIn](https://www.linkedin.com/in/eddonner/) - I love connecting!
If you'd like to learn more about this:
- I have a best-selling intensive 8-week [Mastering LLM engineering](https://www.udemy.com/course/llm-engineering-master-ai-and-large-language-models/?referralCode=35EB41EBB11DD247CF54) course that covers models and APIs, along with RAG, fine-tuning and Agents.
- I'm running a number of [Live Events](https://www.oreilly.com/search/?q=author%3A%20%22Ed%20Donner%22) with O'Reilly and Pearson
## Installing the code
1. Clone the repo with `git clone https://github.com/ed-donner/connect.git`
2. Change to the project directory with `cd connect`
3. Create a python virtualenv with `python -m venv venv`
4. Activate your environment with either `venv\Scripts\activate` on Windows, or `source venv/bin/activate` on Mac/Linux
5. Then run `pip install -r requirements.txt` to install the packages
If you wish to experiment with the prototype, run `jupyter lab` to launch the lab then look at the notebook **prototype.ipynb**.
To launch the app locally, run `python app.py`
## Setting up your API keys
Please create a file with the exact name `.env` in the project root directory (connect).
You would typically use Notepad (Windows) or nano (Mac) for this.
If you're not familiar with setting up a .env file this way, ask ChatGPT! It will give much more eloquent instructions than me. 😂
Your .env file should contain the following; add whichever keys you would like to use.
```
OPENAI_API_KEY=sk-proj-...
ANTHROPIC_API_KEY=sk-ant-...
DEEPSEEK_API_KEY=sk...
GROQ_API_KEY=...
```
## Optional - using Ollama
You can run Ollama locally, and the Arena will connect to run local models.
1. Download and install Ollama from https://ollama.com noting that on a PC you might need to have administrator permissions for the install to work properly
2. On a PC, start a Command prompt / Powershell (Press Win + R, type `cmd`, and press Enter). On a Mac, start a Terminal (Applications > Utilities > Terminal).
3. Run `ollama run llama3.2` or for smaller machines try `ollama run llama3.2:1b`
4. If this doesn't work, you may need to run `ollama serve` in another Powershell (Windows) or Terminal (Mac), and try step 3 again
|