Summary

"Ten Cycles of Fate" is a web-based, immersive text adventure game where players navigate AI-dynamically generated life stories across ten daily "dream" cycles. It targets players seeking unique, unpredictable narratives driven by AI, focusing on the core choice between contentment and greed. The game offers a distinct, engaging experience through its AI-driven storytelling and interactive decision-making.

How It Works

The game leverages large language models (LLMs) like GPT-4o to generate unique, real-time narrative content for each playthrough. Player interactions are managed via WebSockets for a fluid, responsive experience. A novel "Fate Judgment" system incorporates AI-requested D100 rolls to dynamically alter story outcomes, adding layers of chance and drama. An AI-powered anti-cheat mechanism monitors player input to maintain game fairness.

Quick Start & Requirements

Deployment requires Python 3.8+, Git, and optionally uv for dependency management. After cloning the repository, install backend dependencies using uv pip install -r backend/requirements.txt or pip install -r backend/requirements.txt. Crucially, users must configure environment variables in backend/.env, including an OpenAI API key, Linux.do OAuth credentials, and a strong SECRET_KEY. The application is launched via the ./run.sh script, accessible at http://localhost:8000.

Highlighted Details

• Dynamic AI-generated content ensures unique, unpredictable story paths.
• Real-time communication via WebSockets provides a smooth, interactive experience.
• Features a "Jiangnan garden" inspired UI for immersive visuals.
• Interactive "Fate Judgment" system uses AI-prompted D100 rolls to influence narrative.
• AI-based anti-cheat mechanism detects and penalizes disruptive player behavior.
• Game state is persisted and reloaded upon application restart.

Maintenance & Community

No specific details regarding maintainers, community channels (e.g., Discord, Slack), or project roadmaps were found in the provided README.

Licensing & Compatibility

The README does not specify a software license. This omission prevents an assessment of compatibility for commercial use or closed-source integration.

Limitations & Caveats

The project's functionality is dependent on external API services (OpenAI, Linux.do OAuth), introducing potential costs and service availability risks. Setup requires obtaining and configuring sensitive API keys and OAuth credentials. The effectiveness and potential false positives of the AI anti-cheat system are not detailed. The absence of a stated license is a significant blocker for adoption assessment.