A terminal-based ai simulation game.
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, Ubuntu 26.04 LTS |
| MacOS | macOS 13, macOS 14, macOS 15, macOS 26 |
Manual run
-
Clone the repository:
git clone https://github.com/luyiourwong/Terminara cd Terminara -
Install environment: We recommend using uv>=0.4.27 to synchronize locked dependencies.
uv sync source .venv/bin/activateOn Windows, use
.venv\Scripts\activate
After installation, run the game with:
terminarafor more information, see Contribute & Develop Guide.
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)
- 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.
Click "Apply" to save the settings.
1. OpenAI (Default)
- Host: (leave empty)
- API Key:
YOUR_OPENAI_API_KEY - Model:
gpt-4o-mini-2024-07-18
- Host:
https://generativelanguage.googleapis.com/v1beta/openai/ - API Key:
YOUR_GEMINI_API_KEY - Model:
gemini-2.0-flash
World settings are stored in the terminara/data/worlds directory. (in full release)
.
|-- terminara/
| `-- data/
| |-- schema/ # Json schema files for world settings
| `-- worlds/ # Directory for world setting files
`-- terminara_platform_version # Executable file
There is a example world aethelgard.json. You can follow the schema to create a new world.
This project is licensed under the MIT License.