Skip to content

Getting started

Installation

Recommended installation methods:

uv tool install secchi

pipx install secchi

pip install secchi

Inspect a package directly

No configuration file is required for direct package commands:

secchi show duckdb
secchi dashboard duckdb
secchi search duckdb
secchi compare pypi:duckdb pypi:polars

Use --registry when a package name is ambiguous or when you want one specific ecosystem:

secchi show duckdb --registry pypi
secchi dashboard serde --registry crates.io

Create a workspace

Create a starter configuration interactively:

secchi init

Then launch the configured dashboard:

secchi dashboard

Secchi searches for configuration in this order:

  1. The path passed with --config or -c
  2. ./secchi.toml
  3. ./.secchi.toml
  4. ~/.config/secchi/config.toml

See Workspace for the full configuration model.

Refresh data

Package data is cached locally for the current day. Use --refresh when you need to request fresh registry data:

secchi dashboard duckdb --refresh
secchi report duckdb --refresh --format json

Optional signals such as download history or reverse dependencies may be unavailable because of registry rate limits or missing endpoints. Secchi keeps the package result available and reports warnings for missing signals.