NeonRP

A developer-friendly command-line engine for playing and iterating on file-backed text RPGs — your whole world is plain files you can read, diff, and version.

Install

# macOS / Linux
curl -LsSf https://worldlines.gg/install.sh | sh

# Windows (PowerShell)
irm https://worldlines.gg/install.ps1 | iex

Installs uv (if missing) then uv tool install worldlines. Verify with neonrp --help — or just run worldlines. The curl/irm path avoids the macOS Gatekeeper and Windows SmartScreen prompts a downloaded file would trip.

Desktop app (no terminal)

Download WorldLines Desktop and double-click it. It bootstraps the engine on first launch and opens the full local web product.

Platform	Download
macOS (Apple Silicon)	`WorldLines-Installer.dmg`
Windows	`WorldLines-Desktop-windows-x64-setup.exe`

Because the app isn't signed yet, the first run only needs one approval:

macOS — right-click the installer → Open → Open. It downloads and installs the desktop app into Applications; afterwards WorldLines opens with a normal double-click.
Windows — SmartScreen → More info → Run anyway.

macOS/Windows remember the choice afterward. Linux uses the terminal install above.

Users in China (throttled GitHub / Cloudflare)

If curl https://worldlines.gg/install.sh times out:

# Force uv onto a China-hosted PyPI mirror, then install:
export UV_DEFAULT_INDEX=https://pypi.tuna.tsinghua.edu.cn/simple
uv tool install worldlines

# …or pass CHINA_MIRROR=1 to the installer in one shot:
CHINA_MIRROR=1 curl -LsSf https://worldlines.gg/install.sh | sh

Alternative mirrors: mirrors.aliyun.com/pypi/simple, mirrors.cloud.tencent.com/pypi/simple. neonrp self-update honors the same UV_DEFAULT_INDEX, so exporting it in your shell profile keeps upgrades on the mirror too.

Developers — editable install

uv tool install -e /path/to/NeonRP   # picks up local code changes
neonrp --help

Play

neonrp                       # launch the TUI → pick a built-in world → play

That's it. Prefer driving the engine from the shell?

neonrp init                  # scaffold a project in the current dir
neonrp run "look around"     # take a turn
neonrp save                  # checkpoint
neonrp undo                  # step back
neonrp branch "steal-route"  # fork an alternate timeline

neonrp init is enough to start in TUI build mode; fresh projects expose the packaged builtin worlds and skills automatically.

Why an engine, not a web chat

NeonRP is built around engine-like guarantees a chat box can't give you:

Resume / Undo / Branch — checkpointed gameplay you can safely explore.
Plan → Diff → Apply — changes are visible and validated before they land.
Append-only events + snapshots — reproducible, debuggable runs.
Minimal-context retrieval — fast even with large worlds.
Sandbox & Replay — isolated experimentation and determinism checks.

Terminal UI

neonrp tui                          # interactive gameplay
neonrp tui --continue               # resume the last session
neonrp tui --provider lmstudio      # local OpenAI-compatible server
neonrp tui --import-card char.png   # import a SillyTavern card first

Single-pane Claude Code-style transcript + input, slash-command workflow with completion, live token counters, and streaming output.

Key	Action		Key	Action
`q` / `Ctrl+Q`	Quit		`Ctrl+K` / `Ctrl+P`	Command palette
`Esc`	Interrupt the in-flight turn		`F6`	Copy full transcript

See the TUI Guide for the full picture.

Testing

uv run pytest -q                                     # fast regression
uv run pytest --cov=neonrp --cov-report=term-missing # coverage
NEONRP_E2E_LLM=1 uv run pytest tests/test_llm_real_endpoint.py -q  # real LLM e2e

Documentation

CLI Reference — every command: validate, index, agents, import, sandbox/replay, embedding retrieval, and more.
Tutorial: Your First Game — zero to first turn.
TUI Guide — terminal UI documentation.
Architecture Overview — system design.
Roadmap — 见 cockpit/mvp 与 docs/M 系列(旧 PRODUCT_ROADMAP 已归档至 docs/_archive/)。
Developer Guide — contributing and internals.

Metadata

Release files for neonrp 0.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for neonrp 0.4.1
File	Size	Uploaded
neonrp-0.4.1.tar.gz	47.0 MB	Sep 10, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for neonrp 0.4.1
File	Interpreter	ABI	Platform	Reset
neonrp-0.4.1-py3-none-any.whl 43.2 MB Sep 10, 2026	Python 3	none	any	Details

Total release size: 90.2 MB

Release files / neonrp-0.4.1.tar.gz

Download URL	neonrp-0.4.1.tar.gz
Size	47.0 MB
Tags	Source
SHA-256 checksum How to use checksums	`de12be09c618fcf21ee95d27ed54e096fcf03fa9e5a89773ad3aba6a3fe7fa4d`
BLAKE2b-256 checksum How to use checksums	`bc3c1f2e80048b26ad55fe13cd10d262f4e0d6ca67a822c303e9924f8ea36aa8`
Upload date	Sep 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/LudicDynamics/NeonRP
Publishing commit: github.com/LudicDynamics/NeonRP/tree/04138eeb91150e2f9911d931ef1ab5831bdf0d52

Workflow

Publishing configuration: github.com/LudicDynamics/NeonRP/blob/04138eeb91150e2f9911d931ef1ab5831bdf0d52/.github/workflows/release.yml
Publishing logs: github.com/LudicDynamics/NeonRP/actions/runs/34513168455/attempts/1

Artifact

Subject: neonrp-0.4.1.tar.gz
SHA-256 checksum: de12be09c618fcf21ee95d27ed54e096fcf03fa9e5a89773ad3aba6a3fe7fa4d Verifying attestations

Release files / neonrp-0.4.1-py3-none-any.whl

Download URL	neonrp-0.4.1-py3-none-any.whl
Size	43.2 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`50285ec8d74684421d9ed24637a8dfbe7b7d08d0b0b0d64fe17ce5cf836b4204`
BLAKE2b-256 checksum How to use checksums	`a5d8b904bc3e749eab35e614702f89c3320d7be60281a348df0daeb9f37f41d0`
Upload date	Sep 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/LudicDynamics/NeonRP
Publishing commit: github.com/LudicDynamics/NeonRP/tree/04138eeb91150e2f9911d931ef1ab5831bdf0d52

Workflow

Publishing configuration: github.com/LudicDynamics/NeonRP/blob/04138eeb91150e2f9911d931ef1ab5831bdf0d52/.github/workflows/release.yml
Publishing logs: github.com/LudicDynamics/NeonRP/actions/runs/34513168455/attempts/1

Artifact

Subject: neonrp-0.4.1-py3-none-any.whl
SHA-256 checksum: 50285ec8d74684421d9ed24637a8dfbe7b7d08d0b0b0d64fe17ce5cf836b4204 Verifying attestations