# spacejam/tla-rust

writing correct lock-free and distributed stateful systems in Rust, assisted by TLA+

Repository: https://github.com/spacejam/tla-rust
Canonical: https://ross.abutalabs.com/products/tla-rust
Language: TLA
License Family: other
Topics: tla, rust, model-checking, lock-free, distributed
Last push: 2017-05-23T11:03:58+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3471, "days_push": 3389, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1068, forks 26 (observed 2026-08-28T04:03:27.419331+00:00)

## What it is
A tutorial-style repository and work-in-progress project for writing correct lock-free and distributed stateful systems in Rust, verified with TLA+ model checking and simulated network failures. It documents modeling with TLA+/PlusCal and testing with quickcheck, intended to underpin projects like rsdb and rasputin.

## Use cases
- learn TLA+ for verifying distributed algorithms
- model-check lock-free data structures in Rust
- simulate network partitions in tests
- verify consensus protocol correctness
- learn formal methods for systems programming

## When to choose
- learning TLA+ and PlusCal for concurrent and distributed algorithm verification
- studying how to combine Rust with formal model checking and simulation testing

## When to avoid
- you need a production-ready library or tool - this is largely an unfinished tutorial
- you need maintained code - the last release was 2017 and many sections are incomplete

## Facets
- artifact type: learning-resource
- maturity: abandoned
- function: testing, fuzzing, concurrency, simulation
- domain: microservices, developer-tools, tutorials
- platform: rust, windows
- tags: tla-plus, model-checking, lock-free, quickcheck, formal-verification, distributed-systems, algorithms, linux, macos

## Member repositories
- spacejam/tla-rust (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:27.419331+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-30T06:55:07.780096+00:00, confidence not recorded.
  - readme: https://github.com/spacejam/tla-rust (fetched 2026-08-28T04:03:27.419331+00:00, sha 3afceb63b681)
- Data as of 2026-08-30T08:39:29.467469+00:00.