README.md

metadata

title: CityQuest AI
emoji: 📉
colorFrom: pink
colorTo: blue
sdk: gradio
sdk_version: 6.16.0
python_version: '3.12'
app_file: app.py
pinned: false
license: apache-2.0
short_description: A Multiplayer game to explore cities in the vintage way

🎮 AI-Powered Real-World Game Platform

An AI-powered platform that generates complete, playable real-world games — rules, tasks, hints, scoring, and a narrative summary — based on game type, location, and player preferences.

Games Supported

• Scavenger Hunt
• Hide & Seek
• Tag

How It Works

1. Select a game type, city, and preferences
2. AI generates rules, tasks, and hints
3. Play in the real world, track progress in the app
4. Record voice journals during play (auto-transcribed with Cohere Transcribe)
5. Receive an AI-generated story summary of the outcome

AI Models

Stage	Model	Notes
Game generation	nvidia/NVIDIA-Nemotron-3-Nano-4B-GGUF via llama.cpp	Retrieval-grounded, validation + repair enforced
Voice journal ASR	CohereLabs/cohere-transcribe-03-2026 via 🤗 Transformers	14 languages, lazy-loaded; typed-input fallback
Recap (optional)	openbmb/MiniCPM5-1B-GGUF	Currently using deterministic template recap for reliability
Poster (optional)	black-forest-labs/FLUX.1-schnell	Skipped under CITYQUEST_SKIP_MODEL

Set CITYQUEST_FAST_TEST=1 to run the entire pipeline without downloading any model weights.

Team

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference