Catalog PyPI
PACKAGE EXPLORERView in registry

ai-dino-in-terminal

PyPI

A terminal Chrome dino runner with human, rule-agent, and LLM modes.

agentdinogamellmrunnerterminal
Versions collected1
Direct dependencies2From release 0.1.1
Last observed21 Oct, 10:31 UTC

README

Version 0.1.1 documentation

DINO RUNNER: 一款可以让 AI 玩的终端游戏

安装

推荐用 pipx 安装,这样会把命令行工具放在独立环境里:

pipx install ai-dino-in-terminal
dino

也可以用 pip 安装:

pip install ai-dino-in-terminal
dino

快速开玩

手动玩

dino # 或者 `dino play`

AI 玩

1.AI 模式,不指定 provider。

# 1. 完成安装
# 2. 判断执行模式:
#    2.1. Codex 安装 + 本地已经配置 ak:询问使用哪种模式。
#    2.2. Codex 安装,本地未配置 ak:使用 CODEX 模式。
#    2.3. Codex 未安装,本地已经配置 ak:使用 API 模式。
#    2.4. Codex 未安装,本地未配置 ak:进入 setup 流程。

dino play --llm
  1. AI 模式,指定 provider 为本地 Codex。
# 1. 安装完成
# 2. 判断本地 Codex 是否安装(符合版本要求)
#    2.1. Codex 安装,进入游戏。
#    2.2. Codex 未安装,提示安装,终止游戏。

dino play --llm codex
  1. AI 模式,指定 provider 为 API (OpenAI Response)。
# 1. 安装完成,开始玩
# 2. 判断本地配置文件:
#    2.1. 已经配置 ak,进入游戏。
#    2.2. 未配置 ak,进入 setup 配置流程。

dino play --llm api

其他玩法

保存游戏记录

结束一局游戏后,可以选择保存本局记录。后续可以回放或者在竞技模式中使用。

观看回放

通过 dino replay 选择一局游戏记录回放。

竞技模式

通过 dino compete 选择一局游戏记录,可以一边看回放一边跟玩。

查看游戏数据

使用 dino dashboard 命令查看得分和 token 消耗情况。

完整指令说明

命令说明依赖
dino / dino play手动操作恐龙无
dino play --llm自动选择 API 或 CODEX 模式API 配置或 Codex CLI
dino play --llm api使用 OpenAI Responses API 决策~/.config/ai-dino-in-terminal/config.json 或启动时交互输入
dino play --llm codex使用本地 Codex CLI 决策Codex CLI,且版本满足要求
dino play --llm --debug使用 LLM 决策并写 JSONL 调试日志logs/*.jsonl
dino dashboard查看带动画 banner 的累计得分和 token dashboard~/.config/ai-dino-in-terminal/game_records.jsonl
dino replay从历史运行记录列表选择并重放~/.config/ai-dino-in-terminal/replays/*.json
dino replay +list浏览所有 replay 文件,回车查看元信息~/.config/ai-dino-in-terminal/replays/*.json
dino replay +clear清除所有 replay 记录文件~/.config/ai-dino-in-terminal/replays/*.json
dino compete从历史运行记录列表选择一局并进入双赛道竞技~/.config/ai-dino-in-terminal/replays/*.json
dino config查看本地 LLM 配置(API key 脱敏显示)无
dino config +setup交互式写入本地 API LLM 配置API key / base_url / model
dino setup交互式写入本地 API LLM 配置API key / base_url / model
dino config +reset重置本地 LLM 配置无
dino help查看可用命令和公共参数无

运行要求

  • Python 3.11+
  • 支持 curses 的终端环境
  • 游戏本身无第三方运行时依赖

本地文件写入

数据类型存放目录
配置数据~/.config/ai-dino-in-terminal/config.json
游戏数据 (累计得分、token用量)~/.config/ai-dino-in-terminal/game_records.jsonl
最高分记录~/.config/ai-dino-in-terminal/scores.json
回放数据~/.config/ai-dino-in-terminal/replays/*.json
运行日志(--debug 时打印)当前工作目录下的 logs/*.jsonl

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Versions 1

Collected releases
VersionPublishedDirect dependenciesOpen version
0.1.11 Jun 20262

Package advisories

0
No matching advisories collected

This describes our collected data; it is not a security assessment.

Repository

PENDING
adamwoohhh/agents-competition

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 21 Oct, 10:31 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package:026ae8a0b4abc7788d8614efbbc2064dbb5850b4e22d69d9fa05b79e4dc94b26