https://github.com/fmaclen/julia-sanfrancisco
A clone of the game "Where in the World is Carmen Sandiego?" largely re-created with generative AI.
https://github.com/fmaclen/julia-sanfrancisco
browser-game carmen-sandiego gpt-4 mobile-game stable-diffusion
Last synced: 26 days ago
JSON representation
A clone of the game "Where in the World is Carmen Sandiego?" largely re-created with generative AI.
- Host: GitHub
- URL: https://github.com/fmaclen/julia-sanfrancisco
- Owner: fmaclen
- License: apache-2.0
- Created: 2023-04-15T23:15:33.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-19T21:24:23.000Z (8 months ago)
- Last Synced: 2025-03-27T14:50:07.220Z (about 1 month ago)
- Topics: browser-game, carmen-sandiego, gpt-4, mobile-game, stable-diffusion
- Language: TypeScript
- Homepage: https://julia.fernando.is
- Size: 50.5 MB
- Stars: 9
- Watchers: 2
- Forks: 2
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Julia Sanfrancisco
Chase Julia and her accomplices across different countries, unraveling clues, solving puzzles, and expanding your geography knowledge in this exciting detective game.
đšī¸ [**Play it now**](https://julia.fernando.is) â đģ Devlog on [**Discord**](https://discord.com/channels/532702198040100874/1108858794831790080) & [**Twitter**](https://twitter.com/fmaclen/)
---
## About the project
**Julia Sanfrancisco** is a clone of the 80s MS-DOS game [Where in the World is Carmen Sandiego?](https://archive.org/details/msdos_Where_in_the_World_is_Carmen_Sandiego_Enhanced_1989).
This project is meant as a proof-of-concept for leveraging generative AI to create the game and it's assets.
### Short-term roadmap
- Implement the game mechanics from the original game
- Generate updated clues for the cities featured in the original game
- Generate new artwork for the cities featured in the original game
- Implement a new mobile-based UI with improved UX
Follow the [current progress here](https://github.com/fmaclen/julia-sanfrancisco/issues).
---
## Development
### Current stack
- Written in Typescript using [`SvelteKit`](https://kit.svelte.dev).
- There is no backend, the game runs entirely on the browser.
- Your `name`, `score` and current `play session` is stored locally on your device.
- Clues have been generated with OpenAI's [`GPT-4`](https://openai.com/research/gpt-4).
- Artwork was generated with Stable Diffusion using [`deliberate_v2`](https://civitai.com/models/4823/deliberate).
### Contribute
The game is currently open for contributions. If you want to help, please join the [Discord server](https://discord.com/channels/532702198040100874/1108858794831790080) and/or check the [issues](https://github.com/fmaclen/julia-sanfrancisco/issues) for tasks that need to be done.
### Environment setup
To run the development environment locally:
- Clone the repository.
- Copy `.env.example` and rename it to `.env`.
- Then run:
```bash
npm install
npm run start
```
To create a production version of the game:
```bash
npm run build
```
## References
- Wikipedia: [Where in the World Is Carmen Sandiego?]()