🌐 Language
Terminara
A terminal-based AI simulation game.
How to use
You can download the executable application from latest release.
The full compressed file includes the executable file and the default world settings file. You can only download the executable file if you are updating the game to the latest version.
| OS | Version | |---------|--------------------------------------------------| | Windows | Windows 10, Windows 11 | | Linux | (GLIBC 2.35+) Ubuntu 22.04 LTS, Ubuntu 24.04 LTS | | MacOS | macOS 13, macOS 14, macOS 15, macOS 26 |
Manual run
Installation
- Clone the repository:
git clone https://github.com/luyiourwong/Terminara
cd Terminara
``- Create a virtual environment:
`bash
python -m venv .venv
source .venv/bin/activate
`
On Windows, use .venv\Scripts\activate- Install the dependencies:
`bash
pip install -e .
`
Start Method 1: Using the installed command (Recommended)
After installation, run the game with:
bash
terminara
Start Method 2: Direct execution
Cross-platform waybash
python -m terminara.main
orbash
python terminara/main.py
. |-- terminara/ | -- data/ | |-- schema/ # Json schema files for world settings |On Windows, useterminara\main.pyYOUR_OPENAI_API_KEYfor more information, see Contribute & Develop Guide.
AI Setup
After starting the application, you need to configure the AI settings from the main menu.
You need to fill in the following fields: (OpenAI compatibility API)
Click "Apply" to save the settings.
- Host: The API endpoint. Leave it empty to use the default OpenAI endpoint.
- API Key: Your API key for the AI service.
- Model: The model you want to use.
Examples
#### 1. OpenAI (Default)
- Host: (leave empty)
- API Key:
gpt-4o-mini-2024-07-18Model: https://generativelanguage.googleapis.com/v1beta/openai/#### 2. Google AI Studio
- Host:
YOUR_GEMINI_API_KEYAPI Key: gemini-2.0-flashModel: terminara/data/worldsWorld Setup
Configuration Storage
World settings are stored in thedirectory. (in full release)
-- worlds/ # Directory for world setting files
-- terminara_platform_version # Executable file
```Creating a new world
There is an example world aethelgard.json. You can follow the schema to create a new world.Links
License
This project is licensed under the MIT License.
--- Tranlated By Open Ai Tx | Last indexed: 2025-09-26 ---
