Terminara

Core Features

features.exe

AI-Driven Scenarios

Advanced AI technology creates unique story branches for every choice, ensuring a new experience every time you play.

Load Any World Script

Supports custom world settings, from sci-fi futures to fantasy medieval times, creating your own unique adventure world.

BYOK & Privacy

Use your own API key for complete privacy control and cost transparency.

Full Save/Load System

Save your game progress at any time and load any save point to continue your adventure.

Download & Install

> Get the pre-built executable

installation.sh

or manual installation with Python:

Install Python

Ensure you have Python 3.8 or newer installed on your system.

python --version

Download the Game

Download the latest version from the GitHub Releases.

git clone https://github.com/luyiourwong/Terminara

Install Dependencies

Install the required Python packages.

pip install -e .

Start the Game

Run the game and start your adventure.

terminara

Create Your Custom World!

Want to venture into a medieval fantasy world? Or survive in a cyberpunk metropolis?

With a simple JSON configuration file, you can create any world setting you can imagine. Define characters, backstories, available items, and unique game rules.

The AI will dynamically generate scenarios and dialogues that fit your world setting, giving each custom world a unique gameplay experience.

world_config.json

{
  "world": {
    "name": "aethelgard",
    "description": "A world of myth."
  },
  "ai": {
    "system": "This is aethelgard, a world of myth.",
    "prompt": "Generate stories based on Norse mythology.",
    "lore": {
      "leveling": "Player can level up by doing something brave."
    }
  },
  "variables": {
    "hp": {
      "type": "numeric",
      "description": "Player's health, value 0 will result in a game over.",
      "value": 100,
      "min_value": 0,
      "max_value": 100
    }
  },
  "items": {
    "Potion1": {
      "name": "Heal Potion",
      "description": "Potion to heal.",
      "attributes": {
        "hp": 20
      }
    }
  },
  "scenario": {
    "init": {
      "text": "You awaken in the shadowed halls of Valhalla's outskirts in Aethelgard, a realm woven from Norse myths. The air hums with the whispers of Valkyries, and the distant clash of swords echoes from Ragnarok's edge. A spectral figure, perhaps a draugr, beckons you forward. What do you do?",
      "choices": [
        {
          "text": "1. Approach the spectral figure cautiously"
        },
        {
          "text": "2. Chant an ancient rune to reveal its true nature",
          "actions": [
            {
              "variable_name": "level",
              "value": "1"
            }
          ]
        }
      ]
    }
  }
}
                    

Terminara - An AI Terminal Adventures