Skip to content

About

Persistent Storage for Parameters, KV Cache, and Trajectories

Resources

Stars

4 stars

Watchers

1 watching

Forks

Repository files navigation

Persisting Persisting

Persistent infrastructure for the Agent era.

CI Documentation License: Apache-2.0

Persisting logo

Persisting contains pChronicle, which imports, browses, queries, exchanges, and serves durable Agent trajectory Datasets.

pChronicle

Install

pip install persisting[lance]
pchronicle --version

The rolling nightly build installs the same commands without a Rust toolchain:

curl -fsSL https://raw.githubusercontent.com/DeepLink-org/Persisting/main/scripts/install-nightly.sh | bash

See the installation guide for supported platforms and setup.

Query Agent trajectory history

pchronicle onboard
pchronicle onboard query
pchronicle agent codex ./trajectory-data --ask "Which tools fail most often?"

The onboarding flow creates a temporary example Dataset—no source checkout required. pchronicle import accepts ATIF, ACTF, and OpenAI Messages; pchronicle serve starts a loopback-only, read-only Dataset UI and API.

Current maturity

Capability Status
pChronicle local/S3 catalog, bounded SQL, analysis, find, import/export Implemented
pChronicle loopback-only read API and embedded Web UI Implemented
Queue and document Search Separate stable capabilities
Tensor Memory / TTAS Experimental

Documentation

Criterion.rs microbenchmarks and hyperfine lifecycle scenarios are compared against main in CI; see the benchmark contract.

Latest nightly pChronicle benchmark: eddfafa12595 on linux/x86_64 (2026-10-12T03:15:47.733479+00:00).

Case Metric Value
criterion/atif_conversion/parse_corpus latency_median_ns 5.228e+06 ns
criterion/atif_conversion/roundtrip_corpus latency_median_ns 6.996e+06 ns
system/lance_vs_json/lifecycle cold_query_ms 3044.182 ms
system/lance_vs_json/lifecycle get_storyline_full_ms 10.325 ms
system/lance_vs_json/lifecycle replace_storyline_ms 44.092 ms
system/lance_vs_json/selective lance_qps 327.2 ops/s
system/lance_vs_json/group_by lance_qps 424.8 ops/s
system/lance_vs_json/summary lance_over_json 0.244 ratio
system/json_streaming_ndjson/json_streaming p95_ms 14.698 ms
system/json_streaming_ndjson/json_streaming rows_s 2.756e+05 ops/s
system/json_streaming_ndjson/json_streaming process_peak_rss_mib 47.328 MiB
hyperfine/lance_vs_json wall_median_seconds 40.495 s

Open the complete benchmark run.

License

Apache License 2.0. See NOTICE for third-party attributions and separately licensed bundled components.

About

Persistent Storage for Parameters, KV Cache, and Trajectories

Resources

Stars

4 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages