RDST - Readyset Data and SQL Toolkit

A command-line tool for database diagnostics, query analysis, performance tuning, and caching optimization with Readyset.

What is RDST?

RDST helps you:

Analyze SQL queries for caching opportunities
Identify slow queries in real-time
Get optimization suggestions
Evaluate query compatibility with Readyset cache
Manage database connection profiles

Installation

Using uvx (recommended - no installation required)

Run RDST directly without installing:

uvx rdst --help
uvx rdst analyze "SELECT * FROM users WHERE id = 1"

Using pipx (persistent installation)

Install globally:

# Install
pipx install rdst

# Run
rdst --help

# Upgrade to latest version
pipx upgrade rdst

Using pip

pip install rdst

After installing, run rdst init to configure your first database connection.

Quick Start

Initialize RDST:

rdst init
# Or with uvx (no installation needed):
uvx rdst init

Configure database connection:

rdst configure add-target mydb \
  --host localhost \
  --port 5432 \
  --database myapp \
  --user postgres

Analyze queries:

# Analyze a specific query
rdst analyze "SELECT * FROM users WHERE active = true"

# With uvx:
uvx rdst analyze "SELECT * FROM users WHERE active = true"

# Analyze with Readyset cache evaluation
rdst analyze --readyset-cache "SELECT * FROM products ORDER BY created_at"

Monitor slow queries:
```
rdst top
# Or: uvx rdst top
```

Audit your fleet:

# Snapshot all ReadySet clusters and audit their health
rdst fleet audit --target prod

# Import clusters from your infrastructure
rdst fleet import --target prod

Fleet audit checks cache utilization, query support, and configuration across your ReadySet deployments. See the fleet audit docs for more.

Commands

All commands can be run with rdst (if installed) or uvx rdst (no installation):

rdst analyze - Analyze SQL queries and evaluate caching opportunities
rdst top - Live view of slow queries
rdst ask - Natural language to SQL queries
rdst scan - Scan codebases for ORM queries and analyze performance
rdst fleet audit - Audit ReadySet cluster health and cache utilization
rdst fleet import - Import ReadySet clusters from your infrastructure
rdst schema - Manage the semantic layer for better query generation
rdst query - Manage query registry
rdst configure - Manage database targets and connection profiles
rdst init - First-time setup wizard
rdst version - Show version information

Example with uvx:

uvx rdst analyze "SELECT * FROM orders WHERE status = 'pending'"

Requirements

Python 3.11 or higher
PostgreSQL or MySQL database access

About Readyset

Readyset is a SQL caching engine that sits between your application and database, automatically caching query results to improve performance. Learn more at readyset.io.

Documentation

License

MIT License - see LICENSE file for details

Metadata

Release files for rdst 0.1.1619

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

Source distribution (sdist)

Source distribution for rdst 0.1.1619
File	Size	Uploaded
rdst-0.1.1619.tar.gz	2.6 MB	Jul 30, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for rdst 0.1.1619
File	Interpreter	ABI	Platform	Reset
rdst-0.1.1619-py3-none-any.whl 2.3 MB Jul 30, 2026	Python 3	none	any	Details

Total release size: 4.8 MB

Release files / rdst-0.1.1619.tar.gz

Download URL	rdst-0.1.1619.tar.gz
Size	2.6 MB
Tags	Source
SHA-256 checksum How to use checksums	`8cd0459c5c25c468a1651f24d57caafc6e71a9088e75fdb996e12482878737db`
BLAKE2b-256 checksum How to use checksums	`e38a27f5274c73b64c0d0e85f6356153031600c02d4d730b6fa42c31fe418a5b`
Upload date	Jul 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.9.25`

Release files / rdst-0.1.1619-py3-none-any.whl

Download URL	rdst-0.1.1619-py3-none-any.whl
Size	2.3 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`19176faca198bae5200104286c41d4289efdc44f944ca067f0c291ff4018b156`
BLAKE2b-256 checksum How to use checksums	`0ff21845c927b6f034d38fd21790b5460cef8af54fad94a1d73191fd7c996f62`
Upload date	Jul 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.9.25`