Emtypyie.cli

For downloads and general project details. This wiki covers docs only.

Emtypyie.cli is the package manager and terminal runtime for the EMTYPYIE ecosystem. Running emtypyie with no arguments prints a startup boot animation and drops you into an interactive shell where you can list, install, and manage projects pulled live from a CDN registry.

The project has been maintained continuously since its alpha releases. It started as a Node.js-only tool distributed through npm; from v2.5.0 "Wandering Witches" onward it was rewritten from the ground up in C, and the C build is now the one going forward. See History below for the full timeline.

History

• Alpha
  Node.js-only, npm distribution
  The original CLI was written entirely in Node.js and shipped only through npm.
• v2.5.0 — "Wandering Witches"
  Major release: rewritten in C
  The first major update. The core was rewritten from scratch in C11/C++17 as a dependency-free native binary. The Node.js build was kept alongside it for compatibility.
• Since v2.5.0
  C is the primary path
  All new features — Larpino, bakafetch, themes — land in the C build first. The Node.js build is maintained but is not guaranteed long-term.
• Upcoming — v3.0.0
  Next major update
  The next major release. Expected to bring the GUI online alongside the terminal runtime.

Core features

• Interactive shell with a startup boot animation (skippable via flag or env var)
• Direct one-off commands without entering the shell, e.g. emtypyie /list
• Live CDN-backed project registry — install, inspect, and update anything listed
• Auto-installer for common toolchains, e.g. /get gcc for GCC/G++
• Larpino — a built-in LLAMA inference engine written directly into the C core
• /bf — a neofetch-style system info screen ("bakafetch") with braille/Unicode art
• Five color themes: slate, green, amber, violet, cyan

Install & Launch

The C native build is the recommended path — it's what current and future development targets. The Node.js build still works but is legacy; treat it as a fallback, not the default.

Windows (Winget / Chocolatey) — C native build, recommended

# Winget
winget install myrachane.emtypyie-cli

# Chocolatey
choco install emtypyie-cli

npm (all platforms) — Node.js build, legacy

npm install -g emtypyie-cli

This is the original distribution path from the project's alpha days. It still receives updates, but new features land in the C build first — and support here may end in a future release.

Launching the shell

Once installed, emtypyie is on your PATH. Run it with no arguments to boot the interactive shell:

emtypyie

# skip the boot animation
emtypyie --no-animation
# or
set EMTYPYIE_NO_ANIM=1

Direct commands also work without ever entering the shell, e.g. emtypyie /list or emtypyie /get gcc.

Commands

Architecture

The C CLI (Root4c) is the primary build going forward — a single portable binary written in C11/C++17 with no runtime dependencies. It's what Larpino and bakafetch are built directly into, and where all new development happens. The Node.js CLI (Root4node) is the original alpha-era codebase, still published to npm, but is now considered legacy.

Larpino inference engine

Larpino, the built-in inference engine, handles:

• GGUF-format LLAMA models — Q4_0, Q4_1, Q5_0, Q5_1, Q8_0, F16, F32
• BPE tokenization with merge rules
• A KV-cached transformer (RoPE, SwiGLU, RMSNorm, grouped-query attention)
• Top-k / temperature sampling

Project listings and metadata for /list, /get, and /info are fetched live from cdn.emtypyie.in/dev — the registry is never bundled with the binary.

Build from source:

cmake -B build
cmake --build build

Release artifacts

Each GitHub release ships two Windows executables:

Dev Logs

Contributors

myrachane creator & maintainer

See more on github.com/myrachane/Emtypyie.cli →