zev とは

zev は、コード、データ、機械学習の成果物のためのコンテンツアドレス指定エンジンです。その中核では、ファイル、ツリー、コミット、データセットのシャード、モデルのチェックポイントといったすべてのオブジェクトが、その内容自体のハッシュによって保存されます。そして、この一つの考え方の上に、履歴の追跡、実際に何が変わったかの理解、大きなファイルの効率的な同期、重複した作業を省く CI の実行、生データから公開された結果までモデルの系譜全体を追跡する、という機能群が積み上げられています。 zev は最初から拡張されることを前提に設計されています。バージョン履歴は基盤であって天井ではありません — コミットを保存する同じエンジンが、機械学習の実験を追跡し、モデルの重みをマージし、メトリクスのドリフトを検出し、再現性を検証し、結果をチェーン上で公証します。新しい機能は、同じオブジェクトストアの上に新しいコマンドと新しい IPLD ノードタイプとして追加されるのであり、外付けの別システムとしてではありません。 ## zev を構成するもの zev は、それぞれ独立して構築・検証されたうえで連携する3つの部分から成ります。 - **`zev`** — コマンドラインエンジン。ローカルにインストールされ、作業ディレクトリと `.zev/` 以下のローカルなコンテンツアドレス指定オブジェクトストアを管理し、HTTP、SSH、または IPFS 経由でリモートサーバーと通信します。 - **`zev-api`** — サーバー。Zig で書かれており、リポジトリのオブジェクト、マニフェスト、メタデータを PostgreSQL とディスク上に保存し、JSON HTTP API を公開し、認証とアクセス制御を行います。 - **`zev-ci`** — `zev-api` へのプッシュをトリガーとして、分離された Docker コンテナ内でパイプラインを実行する継続的インテグレーションサービス。入力がすでに成功したことのあるステップはスキップします。 ## Zaryn: ウェブプラットフォーム **Zaryn** ([zaryn.xyz](https://zaryn.xyz)) は、このエンジンの上に構築されたホスティングプラットフォームであり、リポジトリ、組織、Issue、プルリクエスト、そして人々が実際に存在し、閲覧される場所です。Zaryn 上のすべてのリポジトリ、コミット、ピン留めされたファイルは、`zev` クライアントがローカルで生成するのと同じコンテンツハッシュでアドレス指定可能です。つまり、ウェブ上で見えるものは別のコピーではなく、同じオブジェクトストアへの直接のビューです。Zaryn が追加するもの: - コード、機械学習モデル、データセット、エージェント、ネットワークトポロジー定義のためのリポジトリ。それぞれに Issue、プルリクエスト、コントリビューターグラフが付属 - 独自の暗号学的アイデンティティを持つ組織。組織を代表して承認されたコミットは、特定のメンバーとは独立に検証可能 - ユーザー間のリアルタイムメッセージングと通知 - 署名付きアテステーション付きの IPFS ピン留め。ピン留めされたファイルの真正性をオフラインで検証可能 - 公開アクティビティフィードと、コミット・リポジトリ全体にわたる全文セマンティック検索 - `zev-agent` による任意の Kubernetes クラスターや Docker ホストへのデプロイ：署名済みビルドのみ、Prometheus メトリクスで判定するカナリアリリース、Vault やクラウドのシークレットマネージャーからのシークレット、複数ターゲットへの段階的リリース、GitOps のエクスポートと同期、プロジェクトロール、監査ログ、組織向けシングルサインオン — 人、CI、AI エージェント（`zev-deploy`、MCP）から利用可能 ## 中核となる機能 **あらゆる場所でのコンテンツアドレス指定。** すべてのオブジェクトは、その内容自体のハッシュによって識別されます。リポジトリの履歴のどこにあっても、同一のファイルは自動的に同じオブジェクトを占有します。 **大きなファイルのためのチャンク分割。** 大きなファイルはコンテンツ定義のチャンクに分割されるため、小さな編集でも実際に変更されたバイトのみを転送すれば済みます。 **コードのための AST 対応差分。** zev は Zig ソースコードを実際の AST パーサーで解析し、関数のリネーム、シグネチャの変更、本体の変更といった構造的な変更を報告します。単なる行ベースのテキスト差分ではありません。 **機械学習の実験とデータセットの追跡。** `zev experiment`、`zev dataset`、`zev lineage` は、仮説、データセットの分割、シャードの割り当て、そしてモデルを元のデータとスクリプトにつなぐ系譜グラフ全体を追跡します。 **モデルの重みの差分とマージ。** `zev wdiff` は `.safetensors`、PyTorch、NumPy ファイル内のテンソルを直接比較します。`zev merge-weights` は、平均化、重み付き補間、球面線形補間(SLERP)、TIES-merging によってチェックポイントをマージします。 **ドリフト、回帰、再現性。** `zev drift` と `zev threshold` はベースラインに対するメトリクスの回帰を自動的に検出します。`zev reproduce` は記録済みのコマンドを再実行し、その出力を許容誤差の範囲内で記録済みの結果と照合します。 **CI のための系譜とメモ化。** ソースの内容、コンテナイメージ、コマンドの正確な組み合わせがすでに一度成功している場合、CI はパイプラインステップの再実行を完全にスキップできます。 **公証と連合マージ。** `zev notarize` はスナップショットのハッシュをチェーン上に固定します。`zev fedmerge` は、中央サーバーを必要とせず、2つのリポジトリ間で直接交換される `.car` ファイルから作業をマージします。 ## 誰のためのものか zev は実際に動作するシステムとして構築されています — このドキュメントに記載されているすべての機能は、実装され、実際のサーバーにデプロイされ、実際のコマンドと実際のデータに対して検証されたうえで、ここに記述されています。これは意図された動作の仕様ではなく、実際に稼働しているシステムが実際に行っていることの記述です。