The Endless Tale

An Interactive Story Adventure

An AI-powered interactive fiction and storytelling engine that brings characters to life through dynamic conversations and objective-driven gameplay.

Get Started View Source

Immersive Features

🎮

Gamified Experience

Blends traditional AI chat with structured gameplay. Your actions are constantly evaluated against specific story objectives you must complete to advance the narrative.

🤖

Autonomous Character AI

Every character possesses their own distinct personality, independent thought process, and unique way of analyzing and reacting to the evolving situation.

🌍

Dynamic World State

The environment naturally shifts around you as time passes, scenes transition, and characters autonomously decide to enter or leave your current location.

Getting Started

1. Prerequisites

Python 3.10+
Google Gemini API key

2. Installation

git clone https://github.com/Jit-Roy/The-Endless-Tale.git
cd "The Endless Tale"
pip install -r requirements.txt

3. Environment Variables

Create a .env file in the root directory and add your Google Gemini API keys:

GOOGLE_API_KEY=your_primary_api_key_here
BACKGROUND_GOOGLE_API_KEY=your_background_api_key_here

4. Run the Engine

python app.py

Creating Custom Stories & Characters

You can easily build your own dynamic adventures by defining a story directory with JSON files.

{
    "title": "Space Odyssey",
    "description": "A journey to the stars.",
    "objectives": [
        "Wake up from cryo-sleep",
        "Fix the main engine",
        "Navigate the asteroid field"
    ]
}