Getting Started

PermeantOS is a validated early platform for live AI agent state migration. Start locally with the Rust CLI, then move to runtime adapters and cloud validation when you need real-runtime evidence.

Requirements

• Rust stable toolchain.
• Python 3.10 or newer for runtime adapters and validation scripts.
• Optional Apple Silicon MLX environment for live source-runtime tests.
• Optional AWS GPU quota for real vLLM target validation.

Build

git clone https://github.com/kabudu/permeant-os.git
cd permeant-os
cargo build --locked

Run The Starter Demo

./target/debug/permeant-cli starter-demo --seq-len 128 --out-dir .permeant-demo

The starter demo starts a loopback target daemon, migrates a small simulated KV cache, commits it, validates the manifest, and writes .permeant-demo/starter-demo-report.json.

Run A Manual Local Simulated Migration

Start the target daemon:

./target/debug/permeant-cli daemon --addr 127.0.0.1:9099

In a second terminal, run a simulated migration:

./target/debug/permeant-cli sim-migrate \
  --target-addr 127.0.0.1:9099 \
  --seq-len 512

The command writes a migration-*-manifest.json file that can be inspected or summarised by the benchmark tooling.

Next Steps

• Read the evidence guide before making claims about supported runtime paths.
• Read the adapter authoring guide before adding a runtime.
• Read the release artifacts guide to build and verify a binary bundle.