Repository navigation
keep-v0.1.0-alpha.3
Pre-release
Keep 0.1.0-alpha.3 release notes
Keep provides shared local memory for AI agents through stdio or protected HTTP.
This alpha provides Linux x64 with glibc, Windows x64, and macOS Apple Silicon archives.
The Linux archive requires glibc 2.39 or later, such as Ubuntu 24.04.
HTTP mode now accepts --bind-address with a literal IPv4 or IPv6 address.
Use it with --port to select an interface or a container listener. The default remains 127.0.0.1.
Bearer authentication, Origin rejection, and exact Host checks remain required.
The HTTP reference explains listener addresses and HTTPS proxies.
The document API, license, and dependency notices remain unchanged.
Windows includes the required Microsoft Visual C++ runtime.
Tested systems
| Condition | Linux x64 | Windows x64 | macOS arm64 |
|---|---|---|---|
| OS | Ubuntu 24.04.5 LTS; kernel 6.8.0-142-generic | Windows 11, build 10.0.26200 | macOS 26.5.1 |
| Visible logical CPUs | 16 | 32 | 8 |
| Physical memory bytes | 16,765,132,800 | 66,217,689,088 | 17,179,869,184 |
| Model, cache recovery, and backup checks | Passed | Passed | Passed |
These are tested hosts, not minimum system requirements. No clean-machine installation result is claimed.
Model and limits
Default search is lexical and needs no model. Add --semantic to enable hybrid search with a local model.
The archives contain no model weights; the first enabled start can download about 86 MiB.
The pinned model is Snowflake/snowflake-arctic-embed-xs, revision d8c86521100d3556476a063fc2342036d45c106f.
All three platforms passed model checksum checks, corrupt-cache recovery, hybrid search, and lexical fallback after model failure.
Hybrid search permits at most 512 documents, 4,096 chunks, and 8,388,608 searchable text bytes across the store.
Narrow filters do not bypass these limits. Use lexical search when a model is unavailable or a hybrid limit is exceeded.
The measured dataset contains 512 documents, 4,096 chunks, and 6,814,994 searchable text bytes.
It does not exercise the complete 8 MiB text limit. Lexical search remained available after a 513th document exceeded the document limit.
Observed costs
| Measurement | Linux x64 | Windows x64 | macOS arm64 |
|---|---|---|---|
| Initial download, verification, and model load | 2.320 s | 6.656 s | 2.478 s |
| Model load with verified cache in a fresh process | 111.277 ms | 79.000 ms | 53.427 ms |
| Index wall time | 770.966 s | 648.750 s | 574.062 s |
| Index CPU time | 1,006.890 s | 3,659.578 s | 1,279.270 s |
| Sampled peak resident memory | 206,565,376 bytes | 215,281,664 bytes | 207,683,584 bytes |
| One warm hybrid query | 194.334 ms | 469.000 ms | 465.121 ms |
| Maximum sample gap during initial download and load | 46.846 ms | 657.000 ms | 418.003 ms |
| Maximum sample gap during cached-process measurements | 78.848 ms | 79.000 ms | 439.001 ms |
The hosts are shared, with no exclusive CPU allocation. Linux has a two-CPU quota and a 4 GiB memory limit.
Inherited Linux limits can be stricter. Windows job-object restrictions were not queried.
Cached measurements use a fresh process, verified model files, and the same dataset. The OS file cache stays warm.
Model and index times use observed phase transitions. Index CPU time includes protocol work; resident memory is a sampled peak.
The warm query cost covers one request after readiness.
The requested sample interval is 10 ms. Actual gaps limit precision.
Treat model-load intervals shorter than their maximum sample gaps as coarse observations.
These results establish no general speed benefit, memory maximum, or comparison with another product.
Fresh-agent tasks
Fresh agents completed all five tasks on each native archive.
The tasks covered exact queries, conditional edits, history restoration, archive access, and deletion.
Linux used 22 MCP calls, Windows used 24, and macOS used 20.
Each trial had four requested mutations and one expected not_found response. No unexpected MCP errors occurred.
The evaluator model was GPT-6.1 Sol with medium reasoning. These trials provide exploratory evidence without a product comparison.
Session times include interface readiness and bridge delays. The Windows start time is approximate; client token counts are unavailable.
Integrity and recovery
This alpha uses checksums-only integrity. The archives are unsigned.
Download the archive and SHA256SUMS from the same prerelease. Compare the archive's SHA-256 before extraction.
Use the public README for installation and client setup.
Stop Keep before a backup or restore. A restored backup loses later writes.
Uninstall removes only the executable; the personal store and backups remain on disk.