AWAI NETWORK / NODE GUIDE

手元の node を、
ひとつずつ。

Itonami OS — AIUEOS の Awai 向け distribution →

Mac の Linux VM で native host を起動し、自分の画面で観測する。まずはローカル preview から、常時稼働の分散 node へ進むための手順です。

今使えるのは、ローカル host の観測と console。
2026-10-24（JST）確認。署名付き node 登録、Cell 実行、peer 同期、Yataverse 復元、報酬はまだ接続されていません。本ガイドは、24時間稼働を認定したリリースではありません。

ROLES

host と agent の作業空間を分ける。

2026-10-24 に採用した構成では、Awai Node が実行と資源提供の host、Itonami が agent first の workspaceです。Docker / Podman は node を包む実行方式の一つ。node の identity や app の状態そのものではありません。

名前	担当すること
Awai Node	host の参加、実行・資源・配置・観測。hata で Cell を動かす。
Itonami	agent の目標・計画・記憶・workflow を中心とする作業空間。CLI / headless と人の UI。
Aozora	AT Protocol actor、identity・social / collaboration の app-plane 実装。Itonami と組み合わせる。
Yataverse	CID bytes の保存・取得・複製。kotobase の commit graph / verified head と合わせて状態を復元。

この役割分担は採用済みです。既存の itonami.node.* schema は preview の互換ラベルとして残り、見た目の名称変更だけで network 機能は有効になりません。

BEFORE YOU START

用意するもの。

Apple Silicon の Macと Terminal。今回の配布物は arm64 Linux 用です。Intel Mac / Windows / AIUEOS の起動は、この package では認定していません。
公式手順で導入した Podman と、動作中の Linux VM。
観測ファイルを置く、自分の作業用フォルダ。秘密鍵や profile は入れません。

podman machine list で既存 VM を確認します。VM が無い場合だけ公式手順の podman machine init、停止中なら podman machine start を使います。既存 VM の初期化・置き換えは不要です。

macOS のアプリを直接動かす Mach-O ではなく、Mac 内の Linux VM が native ELF を実行します。表示されるメモリ・uptime も VM の値です。

LOCAL PREVIEW

Mac で起動する。

01 配布物と checksum を取得する

arm64 preview をダウンロード ↓ SHA-256 checksum

約 106 KiB。署名付き release ではありません。checksum は byte の一致を確認するもので、独立した publisher 証明ではありません。

SHA-256: f1125beefac7a2064ffb4ae74796ef0b0aa5f2b9f18a917ba49542de451fe282

shasum -a 256 -c awai-local-preview-20261024-arm64-3.tar.gz.sha256
tar -xzf awai-local-preview-20261024-arm64-3.tar.gz
cd awai-local-preview

checksum が OK の場合にだけ展開・実行します。配布物は native ELF 2本、静的 UI、canonical client-runtime、Containerfile、README、BUILD-INFO、SHA256SUMS です。鍵・認証情報・ユーザーデータは含みません。

02 内容を確認し、image を組み立てる

shasum -a 256 -c SHA256SUMS
podman machine list
podman build --network=none --pull=never --arch=arm64 --tag localhost/awai-node-preview:20261024-arm64-v3 --file Containerfile .
mkdir -p state

FROM scratch なので追加の base image は取得しません。アプリの実行に JVM / nbb / Node.js / C loader は使いません。この Podman 操作は利用者が行う手動 orchestration で、native installer / CDCI controller の認定ではありません。

03 host と console を起動する

先に podman ps -a --filter name=awai-local- で確認します。同じ preview が既に稼働中なら「状態を確認」へ進みます。console を更新する場合は、この手順で作った awai-local-console だけを停止・削除して、新しい image から再作成します。別用途の同名 container は操作せず、異なる名前と port を選んでください。

native host の起動コマンド

awai_preview_run_id="local-$(date +%Y%m%d-%H%M%S)"
podman run -d --name awai-local-host --pull never --read-only --network none \
  --cap-drop ALL --security-opt no-new-privileges --pids-limit 16 --memory 384m --cpus 0.5 \
  -e KEXE_ALLOW=35,37,38,43,44,47 -e KEXE_CAP_RESOURCES_35=/proc:/state \
  -e KEXE_CAP_RESOURCES_43=127.0.0.1:18716 -v "$PWD/state:/state" \
  --entrypoint /node-host-monitor localhost/awai-node-preview:20261024-arm64-v3 \
  local-mac-linux-vm "$awai_preview_run_id" /state

console の起動コマンド

podman run -d --name awai-local-console --pull never --read-only \
  --cap-drop ALL --security-opt no-new-privileges --pids-limit 16 --memory 512m --cpus 0.5 \
  -e KEXE_ALLOW=35,37,38,43,44,46,47 -e KEXE_CAP_RESOURCES_35=/assets:/runtime/src \
  -e KEXE_CAP_RESOURCES_43=0.0.0.0:18714 -p 127.0.0.1:18764:18714 \
  localhost/awai-node-preview:20261024-arm64-v3

host は network none。console は 127.0.0.1:18764 だけで開きます。外部公開 port、login item、自動再起動は追加しません。

04 自分の観測を読み込む

この端末の console を開く ↗

起動した端末のブラウザーで開き、「観測ファイルを開く」から展開先の state/observation.json を選びます。更新するときは新しいファイルを再度読み込みます。自動接続や署名検証済みの live view ではありません。

VERIFY

何が確認できればよいか。

podman ps --filter name=awai-local- に host / console の2プロセスが出る。
podman logs --tail 2 awai-local-host で sequence が増える。通常は15秒間隔。
console に観測番号、VM メモリ、uptime が出る。
参加状態は「未登録」、Cell と報酬は「未接続」のまま。これが今の正しい表示です。

観測ファイルは署名されておらず、真正性・現在の接続状態を証明しません。peer / Cell の未知の数を 0 と推測しません。state は観測の置き場で、agent の鍵・記憶・app 状態の正本ではありません。

LIFECYCLE

止める、再び起動する。

podman ps --filter name=awai-local-
podman logs --tail 2 awai-local-host
podman stop awai-local-host awai-local-console
podman start awai-local-console

停止対象は、この手順で作った2つだけ。再起動する console は同じ container を開始します。host は必要な観測履歴を先に保存し、停止済みのものだけを podman rm awai-local-host で取り除いて、手順03の host 起動コマンドを再実行します。awai_preview_run_id が新しい値になり、観測番号の巻き戻りを避けられます。VM 自体や他の container、state directory は削除しません。

host は最大2,000観測（約8時間20分）、console は最大1,000 request の候補です。arena の上限で早く止まる場合があります。常設運用の restart / recovery は後続の認定です。

THE WHOLE SYSTEM

下が土台、その上に作業空間。

Awai Network は、Kotoba Lisp Machine で構築する agent-centric な分散 app・service・状態・経済圏の全体。次は責務と依存の図で、配置場所を固定する図ではありません。

L7 Itonami — agent-first workspace目標・記憶・計画・workflow。CLI / headless と利用者側 UI。Moss / Weave Frame に近い役割。

L6 app / service CellsAozora の identity・social・collaboration、Murakumo inference、domain apps。実 work と receipt から用途別の会計・決済へ。

L5 app の規則・履歴・同期と永続状態mon / ito / nuno。kotobase commit graph / verified head と Yataverse CID bytes を組み合わせて検証・復元。

L4 hata — Cell conductorCell = mon CID × agent 公開鍵。genesis・履歴・権限・call。node / container が変わっても同じ Cell を保つ。

L3 Awai Node — execution hosthost daemon・資源・配置・観測。Docker / Podman / fune は実行方式の一つ。HoloPort / Holo Node に近い host role。

L2 Kototama ＋ kagi / grant / kekkai実行意味論・metering・native providers、agent ごとの鍵・明示権限と境界。Kotoba / Amu は全層の実装・成果物生成基盤。

L1 AIUEOS → Itonami OS distribution / 対応 OSAIUEOS が共通 OS、Itonami OS が同じ repo・core の Awai 向け構成。今回の Mac preview は arm64 Linux VM を使用。

L0 物理機器CPU / GPU / memory / disk / network。今回の観測値は VM 内の範囲。

横断ビルド基盤: Kotoba → Amu が全層に検証可能な成果物を供給します。経済ループ: 契約 → 実 work → 検証 receipt → 用途別会計・報酬・決済。node の配置や VM の実行許可とは別の権限で接続します。

Holochain との対応

Holochain 側	Awai 側の役割
Holochain / Holo hosting 全体	Awai Network 全体
HoloPort / Holo Node	Awai Node の機器 / 常駐 host
conductor	hata
DNA / Cell	mon / mon CID × agent public key
source chain / per-DNA DHT	ito / nuno
Moss / Weave Frame	Itonami の agent-first workspace。Aozora の identity / collaboration に必要に応じて接続。
hApps / Tools	app / service bundle と Cell

Kototama ≈ EVM は VM の実行意味論の比喩。全世界の chain / consensus / settlement を意味しません。AIUEOS ≈ NixOS は宣言的 OS 層の比喩で、NixOS 互換性を示しません。

Yataverse だけを Holochain DHT と同一視せず、保存する bytes と、app の validation / membership / ordering を分けます。agent の identity は node / container に属しません。node を移っても同じ Cell、author key を変えると新しい Cell への明示 transition です。

Itonami は UI first の launcher に agent を追加する形ではなく、agent の目標・記憶・権限から始めます。agent ごとの kagi signer、用途と期限を限定した delegation、状態の verified commit を中心にし、人の UI は観測と承認を担います。Hermes の profile store / inference rail と Itonami のものは別です。

NEXT GATES

常時稼働の分散 node へ。

Holo の always-on node は、グループの参加者が offline の間も同期相手として残る役割です。Awai でもその方向を目指しますが、今回の preview はまだ同期相手になりません。

agent 別 kagi custody、durable replay / audit、失効・復旧を認定。
署名付き Awai Node 登録と観測、lease / fence を接続。
hata で agent-bound Cell を実行し、権限を検査。
Murakumo・Yataverse と接続し、verified head から別 node に状態を復元。
peer 同期、障害復旧、更新、継続運用を実測してから always-on を認定。

本番運用時の電力・回線・稼働条件、公開範囲、費用と報酬は別途確認します。この preview の起動による network 参加や収益の保証はありません。

HELP & REFERENCES

困ったとき。

console が開かない

Podman machine と2つの container の状態、podman logs awai-local-console、port 18764 の使用状況を確認します。同名 container が既にあれば、状態を確認してからその container の lifecycle を扱ってください。

観測を読み込めない・数値が古い

ファイルは書き込み途中の場合があります。15秒ほど後に再度選択し、sequence と run ID を確認します。不正 JSON や同一 run の巻き戻りは拒否し、以前の有効な表示を保ちます。Mac の sleep / VM 停止中は観測が進みません。

鍵や署名はどこに設定するか

この preview には設定しません。秘密鍵・既存 vault・profile を container や観測フォルダへ入れないでください。agent 別 custody の native 認定後に案内を追加します。

相談する：j@awai.network。相談に秘密鍵・パスワードは不要です。

手元の node を、ひとつずつ。