tuiredis 0.3.1

A beautiful Redis TUI client built with Textual

TuiRedis 🔴

A beautiful, high-performance Redis Terminal UI built with Python & Textual.

English | 中文说明

---

🚀 Features

• 🔗 Connection Management — Connect to any Redis instance (supports Password / DB Indexing).
• 🌲 Hierarchical Key Browser — Interactive Tree view grouping keys by : separator with real-time fuzzy search.
• 📄 Advanced Value Viewer — Native support for viewing & editing String, List, Hash, Set, and Sorted Set.
• ⚡ Pagination & Elastic Loading — Safe loading of millions of keys without blocking the TUI.
• ⌨️ Command Console — Execute raw Redis commands directly within the app.
• 📊 Server Info & Monitoring — View exact server stats, memory footprints, connected clients, and keyspace utilization.
• ✨ CRUD Operations — Create, Read, Update, Delete keys seamlessly.
• ⏱️ TTL Management — View and set key expiration intuitively.
• 🎨 Modern Dark Theme — Redis-branded aesthetics with fluid terminal animations.
• 🛠️ IRedis Integration — One-click launch into iredis terminal via internal bindings.

📦 Installation

TuiRedis is available on PyPI and can be installed using your preferred Python package manager.

Using pipx (Recommended)

pipx install tuiredis

Using uvx / uv

uvx tuiredis
# or
uv tool install tuiredis

Using pip

pip install tuiredis

From Source

# Clone the repository
git clone https://github.com/Wooden-Robot/tuiredis.git
cd tuiredis

# Sync dependencies using uv
uv sync

# Run the project
uv run tuiredis

💻 Usage

If you installed TuiRedis via pipx or pip, you can start it directly from the terminal by running tuiredis. If you cloned from the source, you should use uv run tuiredis instead.

# Launch TuiRedis with the Interactive Connection Dialog
tuiredis

# Fast connect via CLI arguments
tuiredis -H 127.0.0.1 -p 6379 -a mypassword -n 0 -c

# Connect securely via an SSH Tunnel
tuiredis -H 127.0.0.1 -p 6379 --ssh-host my-bastion.com --ssh-user root --ssh-key ~/.ssh/id_rsa -c

# Show all available CLI options
tuiredis --help

⌨️ Keyboard Shortcuts

Key	Action
q	Quit the application
F5	Refresh Key Tree & Info
/	Focus search bar
n	Create a New Key
Tab	Switch between active panels
Ctrl+o	Switch Connection
Ctrl+t	Launch IRedis Terminal (uv will prompt to install if missing)
Ctrl+i	Toggle Server Info Panel

---

Requirements: Python >= 3.10 / Redis Server