Installation

Installation

🌍 English · Polski · Français · Deutsch · 中文

ECLI ships native packages for Linux, FreeBSD, macOS, and Windows, plus a cross-platform PyPI distribution. Pick the path that fits your environment.

Choose your installation method

Method	Best for	Notes
Native package (.deb/.rpm/.pkg/.dmg/.exe)	Production use, system-wide install	Single binary, no Python required
PyPI (pip install ecli-editor)	Python devs, virtualenvs, CI	Requires Python 3.11+ and system deps
From source	Contributors, custom builds	See build-from-source.md

All assets are at the Releases page. Each binary has a .sha256 sidecar for verification.

---

Linux

Debian / Ubuntu

# Download
wget https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_linux_x86_64.deb
wget https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_linux_x86_64.deb.sha256

# Verify integrity
sha256sum -c ecli_0.1.3_linux_x86_64.deb.sha256

# Install
sudo apt install ./ecli_0.1.3_linux_x86_64.deb

Fedora / RHEL / Rocky / CentOS Stream

wget https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_linux_x86_64.rpm
sudo dnf install ./ecli_0.1.3_linux_x86_64.rpm

Arch Linux / Manjaro

No AUR package yet. Use the tarball:

wget https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_linux_x86_64.tar.gz
tar -xzf ecli_0.1.3_linux_x86_64.tar.gz
sudo mv ecli /usr/local/bin/

Generic Linux (any distro)

Use the tarball above, or install from PyPI (see below).

Required system libraries

ECLI binaries are self-contained, but a few system libraries must be present:

# Debian / Ubuntu
sudo apt install libncursesw6 libtinfo6

# Fedora / RHEL
sudo dnf install ncurses

# Arch
sudo pacman -S ncurses

---

FreeBSD

fetch https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_freebsd_x86_64.pkg
sudo pkg add ./ecli_0.1.3_freebsd_x86_64.pkg

ECLI on FreeBSD requires ncurses and libyaml (installed automatically via package dependencies).

---

macOS

ECLI ships as a Universal2 DMG, ad-hoc signed (not notarized). First launch requires manual approval.

# Download
curl -LO https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_macos_universal2.dmg

# Mount and copy
open ecli_0.1.3_macos_universal2.dmg
# Drag ECLI to /Applications, or copy the binary:
cp /Volumes/ECLI/ecli /usr/local/bin/

First launch will be blocked by Gatekeeper. Two options:

Option A (GUI):

• Open System Settings → Privacy & Security
• Scroll to the bottom — you'll see "ecli was blocked"
• Click "Open Anyway"

Option B (CLI):

xattr -d com.apple.quarantine /usr/local/bin/ecli

For full notes: docs/install/macos.md.

---

Windows

Two artifacts available:

Installer (recommended)

# Download from Releases or via curl
curl.exe -LO https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_win_x86_64_setup.exe

# Run installer
.\ecli_0.1.3_win_x86_64_setup.exe

The installer registers ECLI in Programs and Features, adds it to PATH, and creates Start Menu shortcuts.

Portable

curl.exe -LO https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_win_x86_64.exe
.\ecli_0.1.3_win_x86_64.exe README.md

No install — runs from any directory.

Windows SmartScreen will warn on first launch (unsigned executable). Click "More info" → "Run anyway".

For full notes: docs/install/windows.md.

---

PyPI (any platform)

Requires Python 3.11 or newer.

# System-wide (not recommended on managed systems)
pip install ecli-editor

# User install
pip install --user ecli-editor

# Inside a virtualenv (recommended)
python3 -m venv ~/.venv/ecli
source ~/.venv/ecli/bin/activate
pip install ecli-editor

Verify:

ecli --version

System dependencies (terminal libs) must still be present — see distro-specific commands above.

---

Verifying checksums

Every release artifact has a .sha256 sidecar. Verify before installing:

# Linux / macOS / FreeBSD
sha256sum -c ecli_0.1.3_linux_x86_64.deb.sha256

# Windows PowerShell
Get-FileHash -Algorithm SHA256 ecli_0.1.3_win_x86_64_setup.exe
# Compare manually with the .sha256 file contents

---

Uninstall

Platform	Command
Debian / Ubuntu	sudo apt remove ecli
Fedora / RHEL	sudo dnf remove ecli
FreeBSD	sudo pkg remove ecli
macOS	Remove /usr/local/bin/ecli or drag from /Applications to Trash
Windows	Programs and Features → ECLI → Uninstall
PyPI	pip uninstall ecli-editor

Config remains under ~/.config/ecli/ (Linux/FreeBSD), ~/Library/Application Support/ecli/ (macOS), or %APPDATA%\ecli\ (Windows). Delete it manually if desired.

---

Troubleshooting

See Troubleshooting for:

• "ecli: command not found"
• "Library not loaded" (macOS)
• "VCRUNTIME140.dll missing" (Windows)
• Permission denied errors
• Locale and UTF-8 issues