# fastmonkeys/stellar

Fast database snapshot and restore tool for development

Repository: https://github.com/fastmonkeys/stellar
Canonical: https://ross.abutalabs.com/products/stellar
Language: Python
License: MIT
License Family: permissive
Last push: 2024-12-13T16:53:12+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 4450, "days_push": 628, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3852, forks 120 (observed 2026-08-28T04:08:27.132801+00:00)

## What it is
Stellar is a Python CLI tool for taking fast snapshots of PostgreSQL and MySQL databases and restoring them quickly during development. It works by copying databases within the RDBMS and renaming them on restore, making it far faster than dump-based tools.

## Use cases
- quickly restore my database after testing migrations
- snapshot database before switching git branches
- reset local dev database after messing with SQL
- fast alternative to pg_dump and pg_restore
- save and restore database state while developing
- create named database snapshots for local development

## When to choose
- you need very fast database snapshot/restore cycles in local development
- you work with PostgreSQL (or partially MySQL) and frequently switch branches or test migrations
- you can tolerate some risk of data loss in a dev environment

## When to avoid
- production databases or any data you cannot afford to lose
- you need portable snapshot files that can move between machines
- you need full MySQL support or other databases like SQLite

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: database, backup, developer-tools, cli
- domain: databases, developer-tools
- platform: windows, cli, python
- tags: database-snapshots, postgresql, mysql, development-workflow, snapshot-restore, command-line, linux, macos

## Member repositories
- fastmonkeys/stellar (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:27.132801+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:25:57.569830+00:00, confidence not recorded.
  - readme: https://github.com/fastmonkeys/stellar (fetched 2026-08-28T04:08:27.132801+00:00, sha f79fc2ed9a8f)
  - registry_pypi: https://pypi.org/pypi/stellar/json (fetched 2026-08-29T09:20:29.764403+00:00, sha 00bcc3f9871a)
- Data as of 2026-08-30T08:39:29.467469+00:00.