Get started in 2 minutes

Get started in 2 minutes for sigstar. Collect market, on-chain, news and macro data, and explain, forecast and alert on crypto price moves from every angle.

You need a terminal and uv.

uv tool install git+https://github.com/Bit-Primitive/sigstar
mkdir my-sigstar && cd my-sigstar
sigstar init        # writes sigstar.yml and sigstar-rules.yml (edit later if you like)
sigstar run         # collects, organises, analyses and writes the brief

(Once sigstar is on PyPI this becomes uv tool install sigstar.)

The first run fetches 90 days of daily data and 7 days of hourly data for BTC, ETH and SOL. Most sources take seconds; news coverage from GDELT is slow on purpose (GDELT asks for one request every few seconds), so the first run takes several minutes. Later runs only fetch what is new.

Then open reports/sigstar-brief-<date>.html in your browser. It works offline.

Ask about one move:

sigstar explain BTC                    # the latest closed day
sigstar explain ETH --date 2026-10-14  # a given day
sigstar explain SOL --top 3            # the three biggest moves of the last 90 days

Optional extras. Macro data needs a free FRED API key: export SIGSTAR_FRED_API_KEY=.... Alerts can be POSTed to a webhook: export SIGSTAR_ALERT_WEBHOOK_URL=.... On-chain activity comes from a chainstar warehouse: set chainstar: warehouse: path/to/warehouse.duckdb in sigstar.yml. Keys and URLs are only ever read from the environment, never written to files or logs.

If something goes wrong, sigstar says what happened and what to try in two lines; add --debug before the command for the full traceback. sigstar doctor checks keys (set or not, never shown), that each source answers, and summarises its terms.

The rest of this page is the full reference.