ai-murder-mystery-hackathon

ai-murder-mystery-hackathon

The game is afoot

Stars: 160

Visit
 screenshot

AI Alibis is a multi-agent murder mystery game that utilizes AI technology to create an interactive and engaging experience for players. Players can play the game online by following the setup instructions provided in the repository. The game involves solving a murder mystery by interacting with various characters and exploring the narrative. The repository includes code for the API, web interface, and database components required to run the game. Players can also explore the full murder story and learn about the prompting system used in the game. AI Alibis was created by Paul Scotti and Will Beddow.

README:

AI Alibis: Multi-Agent LLM Murder Mystery

Play online

Ai Alibis Logo

Setup

  1. Git clone the repo
git clone https://github.com/ironman5366/ai-murder-mystery-hackathon.git
cd ai-murder-mystery-hackathon
  1. Add your Anthropic API to api/.env file (optionally can export conversations to postgres with DB_CONN_URL="postgresql://link_to_db_conn")
nano api/.env
export ANTHROPIC_API_KEY="YOUR_API_KEY_HERE"
(<ctrl+x , y, enter> to save changes and exit nano)
  1. Install Node dependencies
web/npm i
  1. Start up the api
bash api_start.sh
  1. In separate terminal, start up the web interface
bash web_start.sh
  1. Play the game!

Setup (with Docker)

  1. Git clone the repo
git clone https://github.com/ironman5366/ai-murder-mystery-hackathon.git
cd ai-murder-mystery-hackathon
  1. Set environment variables:
export ANTHROPIC_API_KEY="YOUR_API_KEY_HERE"
  1. Open a terminal in the folder containing this README, then run:
docker compose up

This should start three containers (the database, Python API, and React frontend) and create a persistent volume for the database.

  1. Play the game at http://localhost:3000/

If you change any files (for example, changing the Anthropic model in /api/settings.py), then you will likely need to rebuild the images:

docker compose up --build
  1. To shut everything down, hit CTRL-C or click the stop button in the Docker GUI.

To clean up, use the Docker GUI to delete all containers then go to the "Volumes" tab to delete the associated database volume.

Additional info

You can read the full murder story by checking out web/src/characters.json, which contains the full context provided to each character.

To see how our prompting system works, including our critique and revision approach, check out api/ai.py.

Twitter thread on the game: https://x.com/humanscotti/status/1810777932568399933

Contact

AI Alibis was created by Paul Scotti and Will Beddow.

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for ai-murder-mystery-hackathon

Similar Open Source Tools

For similar tasks

For similar jobs