Notariumドキュメント
ドキュメントのバージョン: latest

クイックスタート

Notariumは、自分のディスク上でプレーンなMarkdownファイルとして構築されたセルフホストのナレッジベースであり、人間とAIエージェントが対等に作業できます。クラウドも独自フォーマットもありません。ノートはフォルダの中にあり、gitを真実の源にできます。

このセクションは、ゼロから稼働中のインスタンスまでの最短ルートです。Notariumを単一のコンテナでデプロイし、Webエディタで最初のノートを作成し、MCP経由で自分のエージェントを接続します。全体でおよそ5分です。

必要なもの

Docker(またはDocker Desktop)と空きポートが1つあれば十分です。それ以外のもの、つまりWebエディタ、エンジン、エージェント向けのMCPエンドポイントは、すべてイメージの中に入っています。Node、データベース、ベクトルインデックスを別途インストールする必要はありません。

仕組み

同じナレッジベースが、2種類の読み手に同時に開かれています。人間はWebエディタを通じて、エージェントはMCPエンドポイントを通じて作業します。どちらも同じノートグラフを見ており、ディスク上ではそれは単なる.mdファイルのツリーです。

flowchart LR
  human([人間]) -->|Webエディタ| core
  agent([AIエージェント]) -->|MCP · start_session| core
  core[Notariumエンジン] --> files[(ディスク上の<br/>Markdownファイル)]
  files -.->|git = 真実の源| git[(リポジトリ)]

核心となる原則はfile-firstです。ノートはファイルであり、誰か他人のデータベースの中の一行ではありません。エクスポートは不要です。なぜなら、あなたは本当の意味で「中に」入ったことは一度もないからです。データは常にあなたのものであり、常にディスク上にあります。

インスタンスを立ち上げる

最も速い方法は、ビルド済みのイメージを実行することです。これは自己完結型で、エンジン、Webインターフェース、MCPエンドポイントを一度にまとめて立ち上げます。

# イメージを取得してコンテナを起動する
docker run -d --name notarium \
  -p 3000:3000 \
  -v notarium-data:/data \
  docouno/notarium:latest

単一の/dataボリュームが、すべての状態を保持します。メタデータデータベース、インデックス群、あなたのノート、そしてエクスポート成果物です。これ以上設定するものはありません。ポート3000とデータパス/dataは、すでにイメージに焼き込まれています。3000の左側にあるポートは、任意の空きポートに変更できます。

http://localhost:3000を開くと、初回起動のセットアップ画面が出迎えます。ここでインスタンスのオーナー(最初のアカウント)と、出発点となる(個人用の)スペースが作成されます。その後は、もうエディタの中です。

ポートとデータ

ポート3000は、-p <yours>:3000<yours>(左側の数字)を任意の空きポートに書き換えて変更できます。docouno/notariumイメージは公開されており、これがメインのインストール経路です(詳細とソースからのビルドはインストールのページにあります)。/dataボリュームはコンテナを作り直しても残ります。ただしボリューム自体は守ってください。ボリュームが失われれば、データも一緒に失われます。

初回起動時に内部で起きていること:

  • エンジンが起動し、指定したポートでWebインターフェースを提供する。
  • /dataボリュームの中に、あなたのスペースのツリーが初期化される。
  • セットアップ画面がオーナー、つまりインスタンスを所有するアカウントを作成する。

次のステップ

インスタンスが立ち上がりました。次は3つの短いステップです。それぞれが個別のページで解説されています:

ステップページ得られるもの
1インストールと起動docker / make up、ボリューム、セットアップ画面の手順解説
2最初のノートファイルツリー、Webエディタ、.mdへの保存
3エージェントを接続するトークン、POST /mcpエンドポイント、start_sessionの呼び出し

まずモデル全体を把握したいですか。コンセプトのセクションを覗いてみてください。スペースとプロジェクト、ノートの種類、ナレッジグラフ、そして人間とエージェントのアクセスモデルについて解説しています。