RoboSystems

RoboSystems

RoboSystems は、会計、財務報告、投資管理のためのオープンソースの AI ネイティブな財務インテリジェンスプラットフォームです。財務データをナレッジグラフとしてモデル化します — トランザクション、ファクト、報告要素、およびそれらを関連付ける計算構造はすべてノードとエッジであり、そのセマンティクスは、クエリで扱うために行に平坦化されることなく保持されます。そのグラフの上に、AI エージェントとアナリストの両方がクエリと操作を行える台帳グレードのシステムオブレコードを提供します — 帳簿の締め処理、レポートの作成、そして自社の台帳、保有資産、および SEC 公開提出書類を並べてクエリ可能な形でのポートフォリオ分析を実現します。RoboLedger と RoboInvestor を支えています。

すべてのテナントが独自のグラフを取得します。 共有テーブルの行レベルのスライスではなく、専用のインスタンス上の専用グラフデータベースであり、その背後には専用の OLTP スキーマがあります。あなたのオントロジー、タクソノミー、および計算構造は、読み取り、エクスポート、持ち出しが可能なアーティファクトとしてその中に存在します。

プラットフォーム

プラットフォームは、すべての拡張機能が構築する基盤となるコアインフラストラクチャを提供します。

• 専用インフラストラクチャ: 専用インスタンスと設定可能なメモリ割り当てを備えた、階層型 LadybugDB グラフインフラストラクチャ
• AI オペレーターシステム: 自動クレジット追跡と SSE 進捗ストリーミングを備えた自律型財務オペレーター（Claude/MCP エグゼキューター）
• 共有リポジトリ: コンテキストマイニングとベンチマーキングのための SEC XBRL 提出書類ナレッジグラフ
• ドキュメント管理: OpenSearch を介した全文検索とセマンティック検索による、ドキュメントのアップロード、インデックス作成、検索
• クレジットベースの課金: トークン使用量に基づく AI オペレーション向けの柔軟なクレジット
• サブグラフ（ワークスペース）: 開発とチームコラボレーションのための AI メモリグラフと分離された環境
• Web アプリケーション: 主要な Web インターフェース — グラフ管理、AI クエリコンソール（MCP 経由の自然言語 + Cypher）、スキーマエクスプローラー、ドキュメント検索、共有リポジトリへのアクセス、および課金 — robosystems-app

コアプラットフォーム API は /v1 にあります — 認証、組織、課金、グラフのライフサイクル（サブグラフ、バックアップ、マテリアライズ、ティア変更）、Cypher、および MCP — 読み取りは REST の GET です。すべての書き込みは — コアと拡張機能の両方のサーフェスにわたって — Idempotency-Key をサポートし、監査ログと /v1/operations/{id}/stream 経由の SSE 進捗ストリーミングを備えた、名前付きの OperationEnvelope オペレーションです。

拡張機能

拡張機能は、独自のスキーマ、OLTP テーブル、API ルート、データパイプライン、および専用のフロントエンドアプリを持つドメイン固有のサブシステムです。これらはテナントごとのスキーマ分離を備えた単一の PostgreSQL データベースを共有し、分析クエリのためにグラフにマテリアライズします。ドメインコンテンツはブロック分子として記述されます — 構造、ルール、検証とともに原子的なファクトをバンドルする自己記述的なエンベロープであり、裸の行になることはありません。

拡張機能の API サーフェスは、URL レベルでグラフスコープです — graph_id は常にパスパラメータであり、クエリ引数になることはありません — そしてトランスポートによって読み取りと書き込みを分離します。

• 読み取り → POST /extensions/{graph_id}/graphql — Strawberry GraphQL、開発環境では GraphiQL、有効化されたドメインから動的に構成されるスキーマ
• 書き込み → POST /extensions/{roboledger|roboinvestor}/{graph_id}/operations/{operation_name} — 名前付き REST コマンド
• 分析ビュー → POST /extensions/{domain}/{graph_id}/operations/{view_name} — 読み取り専用の分析オペレーション（例: build-fact-grid、live-financial-statement）、書き込みと同じエンベロープ

API の背後には CQRS オペレーションカーネル（ドメインごとの reads/ + commands/、およびグラフに支えられた views/）があり、これがビジネスロジックの単一の信頼できる情報源です — GraphQL リゾルバー、REST オペレーションルート、MCP ツールはすべて同じ関数に委譲します。ドメインごとのフィーチャーフラグ（ROBOLEDGER_ENABLED、ROBOINVESTOR_ENABLED）は、ルーターと GraphQL スキーマ構成の両方をゲートします。

RoboLedger

会計および財務報告の拡張機能 — AI とアナリストの両方がクエリと操作を行える、元帳グレードの記録システムです。書き込みは自己記述的な**分子（molecules）**として格納されます。つまり、構造的な配線、ルール、検証をひとつの型付きエンベロープにまとめた原子的なファクトであり、裸の行になることはありません。3 つのブロック分子がオーサリングの基盤となります:

• Information Blocks — 報告可能なコンテンツのためのエンベロープ: スケジュール、計算書、指標、およびテキストブロックによる開示を、期間でバージョン管理されたファクトセット、型付きの仕組み、ルールとともに束ねたものです。evaluate-rules はマテリアライズされたファクトに対して算術チェック（EqualTo、RollUp、RollForward、SumEquals、Exists、CoExists）を実行します。ファクトセットをピン留めすることで、ライブの決算中の帳簿と凍結されたレポートが分離されます。
• Event Blocks — REA イベントのキャプチャ: 呼び出し元は、構造化されたアクション動詞の語彙を通じて、現実世界で起きたこと（売上、支払い、資産の処分）を記録し、ハンドラーレジストリが 3 階層の元帳（Transaction → Entry → LineItem）にわたって借方と貸方を導出します。ハンドラーの解決をプレビューし、実行して GL をアトミックに転記し、満期に達した債務（AR/AP、スケジュールエントリ）をオンデマンドで昇格させます。
• Taxonomy Blocks — 会計フレームワークをコードではなくデータとして扱います: Elements、リンクベースの関連（presentation / calculation / mapping）、Structures、および自動生成された構造ルールを 1 回のアトミックな書き込みにまとめます。fac（ファンダメンタルズ）と rs-gaap（厳選された約 2,000 の US-GAAP 概念）を、public→tenant の 2 階層ライブラリとして提供し、CoA→GAAP マッピングは calc-DAG のリーフに固定されます。

ブロックの上に構築されたもの:

• 決算ライフサイクル — 会計カレンダー、決算目標に基づくキャッチアップの順序付け、および貸借等式、QuickBooks の同期の陳腐化、未処理のスケジュール債務を条件とする期間の決算/再開。すべてのブロッカーは、何が決算を妨げているかを明示します
• マッピング — CoA→GAAP マッピングの関連に加え、MappingOperator による AI 支援の一括マッピング（信頼度に応じた階層: 自動承認 / レビュー / スキップ）
• レポーティング — 共有ファクトから Reporting Style を通じてレンダリングされる複数期間のレポート。レポートのライフサイクル（draft → under_review → filed → archived）と、配布のための公開リスト
• 予測 — 同じ計算書構造を通じて投影される事業計画シナリオ: ルール駆動の予測、行ごとの成長軌道、手動による行の主張。計算書の読み取り時には、実績と並んで予測期間が返されます
• 分析操作 — live-financial-statement は OLTP 元帳から直接計算書をレンダリングします（マテリアライズは不要）。build-fact-grid と financial-statement-analysis は、グラフ内のマテリアライズされた XBRL ハイパーキューブをクエリします
• シリアライゼーション — レポートは holon（データセット形式の JSON-LD で、保存されたアンカーであり、レポート全体を運ぶ唯一の形式）として公開されます。初回ダウンロード時に、XBRL International の Tavi コンパイル済みモデルと、提出グレードの XBRL 2.1 パッケージ（Arelle で検証済み）が構築され、これら 3 つはすべて同じ組み立て済みレポートの投影です
• パイプラインとデータ — 設定可能な write_policy を備えた dbt/Dagster 経由の QuickBooks ELT、および SEC XBRL 財務報告

専用のフロントエンドアプリ: roboledger-app。

RoboInvestor

ポートフォリオ管理と投資トラッキングの拡張機能 — 非公開企業への保有株式を追跡し、それらを発行した企業へひも付けます。

• ポートフォリオブロック — RoboLedger と同じ分子規律: ポートフォリオとそのポジションおよび証券は 1 つのエンベロープとして検証・書き込みされ、取得原価と現在価値は整数のセントとして保持され、ドル合計は境界で計算されます。ポジションは active / disposed / archived のライフサイクルを遷移し、読み取りでは portfolios、positions、holdings (発行体ごとに集計)、および組み立て済みの portfolioBlock を公開します。
• 証券 — 所有権を表す金融商品 (普通株式、ワラント、転換社債など) を登録・維持します。商品固有の詳細 (権利行使価格、清算優先権、ベスティング) のための拡張可能な terms blob を備えています
• グラフ横断リサーチ — 証券は、その発行企業もプラットフォーム上で稼働している場合、その企業のグラフを指し示すことができます。投資家は発行体の source_graph_id を事前関連付けとしてあらかじめ記録します。その後、発行体が公開レポートを投資家のグラフへ共有すると、発行体のエンティティがそこに実体化され、その source_graph_id を待っていた証券がそれにリンクします。こうして保有株式は発行体自身が報告したファクトまでたどります — Portfolio → Position → Security → Entity → Report → Fact — 認可はレポート共有の境界で適用され、OLTP 層では適用されません。

専用フロントエンドアプリ: roboinvestor-app。

クイックスタート

Docker 開発環境

# Install uv and just
brew install uv just

# Start robosystems backend
just start

# Start frontend apps - robosystems-app, roboledger-app, roboinvestor-app
just start apps

# Refresh images and recreate the containers that changed (after a git pull)
just upgrade

# Local builds: restart to pick up code changes; rebuild after dependency changes
just restart
just rebuild

これは .env ファイルを初期化し、以下を備えた完全な RoboSystems スタックを起動します:

• LadybugDB および DuckDB バックエンドを備えた Graph API
• データパイプラインオーケストレーション用の Dagster
• IAM、グラフメタデータ、拡張機能、Dagster 用の PostgreSQL
• キャッシュ、SSE メッセージング、レート制限用の Valkey
• 全文検索およびセマンティック文書検索用の OpenSearch
• S3 および DynamoDB エミュレーション用の Localstack

サービスの URL:

Service	URL
Main API	http://localhost:8000
Graph API	http://localhost:8001
Dagster UI	http://localhost:8002

just start apps (フロントエンドアプリ) の場合:

App	URL
RoboSystems App	http://localhost:3000
RoboLedger App	http://localhost:3001
RoboInvestor App	http://localhost:3002

ローカル開発

just start は公開済みイメージをリリースどおりに実行するため、チェックアウトが提供するのは設定であり、コードではありません。自分の変更を実行するには、.env 内のイメージ行をコメントアウトします。するとスタックはチェックアウトからビルドされ、そのソースがマウントされるため、編集内容は just restart で適用されます。

# Setup Python environment (uv automatically handles Python versions)
just init

例

robosystems-client を使ってグラフを作成し、データを読み込み、クエリを実行する実行可能なデモで、RoboSystems の動作を確認できます:

just demo-sec               # Loads NVIDIA's SEC XBRL data via Dagster pipeline
just demo-roboledger        # End-to-end RoboLedger demo: bulk OLTP, schedules, FY 2025 filed report, AI close
just demo-custom-graph      # Builds custom graph schema with relationship networks
just demo-coffee-roaster    # Synthetic manufacturing scenario
just demo-saas-startup      # Synthetic SaaS scenario
just demo-roboinvestor      # Cross-graph traversal from a private holding to its issuer's filed report (run demo-saas-startup first)

各デモには、詳細なガイドを掲載した対応するドキュメントページがあります。

開発コマンド

テスト

just test-all               # Tests with code quality
just test                   # Default test suite
just test adapters          # Test specific module
just test-cov               # Tests with coverage

コード品質

just test-code              # Lint, format, and typecheck (what the git hooks run)
just lint fix               # Auto-fix lint issues
just typecheck              # Type checking

ログ監視

just logs api                 # View API logs (last 100 lines by default)
just logs graph-api           # View Graph API logs
just logs dagster-webserver   # View Dagster Webserver logs
just logs dagster-daemon      # View Dagster Daemon logs

データベースマイグレーション、CloudFormation のリンティング、グラフ操作、管理など 100 以上の開発コマンドについては justfile を参照してください。

前提条件

システム要件

• Docker & Docker Compose
• 最小 8GB の RAM
• 20GB の空きディスク容量

必要なツール

• Python パッケージとバージョン管理用の uv
• プロジェクトのコマンドランナー用の just

macOS および Linux で開発・テストされています。Windows では、リポジトリを Linux ファイルシステム内にクローンしたうえで WSL2 を使用してください — Windows セットアップ (WSL2) ガイド を参照してください。

デプロイ要件

• このリポジトリをフォークする
• IAM Identity Center (SSO) を有効にした AWS アカウント
• just bootstrap を実行して OIDC と GitHub 変数を構成する

完全な手順については Bootstrap Guide を参照してください。

アーキテクチャ

オープンソースのエンジン——PostgreSQL、LadybugDB、DuckDB、LanceDB、OpenSearch、Valkey——を基盤にエンドツーエンドで構築され、トランザクションコア、マテリアライズド分析グラフ、統合ベクトル検索を組み合わせており、プロプライエタリなデータベースへのロックインはありません。

この開放性はスタックの上位にも下位にも及びます。会計オントロジー、レポーティングタクソノミー、計算構造は検査可能でポータブルな成果物であり、あなたが所有するものであって、ベンダープラットフォームに閉じ込められた構成ではありません——あなたの財務データのためのセマンティック主権です。

マルチテナンシーと分離

ひとつのルール: すべての分離プリミティブは graph_id をキーとし、決して組織をキーとしない——セッションの search_path、キャッシュキー、冪等性キー、レート制限バケット、クレジット会計はすべてグラフで名前空間を分けています。同じ組織内の 2 つのグラフは、無関係な 2 つの顧客を分離するのとまったく同じメカニズムで分離され、境界をスキップする「内部」パスは存在しません。

• テナントごとに 1 つのグラフデータベース——すべてのティアは databases_per_instance: 1 で動作するため、ティアの違いはインスタンスサイズであり、1 つを共有するテナントの数ではありません。
• グラフごとのスキーマによる OLTP——各グラフは独自の PostgreSQL スキーマを持ち、search_path はプールされた接続から継承されるのではなく、リクエストごとに再設定されます。CI の構造テストがこの契約を固定します。
• 2 つのデータベース、2 つの移行履歴——プラットフォーム状態 (アイデンティティ、組織、請求) は拡張機能の OLTP とは別であり、一方への移行が他方に触れることはありません。
• グラフは派生プロジェクション——OLTP の行がシステムオブレコードであり、分析グラフはそこからブルーグリーンで再構築されます。これにより再構築はリスクの高い作業ではなく日常的な作業になります。
• サブグラフはテナント内の分離された環境であり、親のクレジットと権限を共有します——AI メモリ、開発、チームワークスペース。
• 共有リポジトリ (SEC XBRL) は唯一のマルチリーダーサーフェスです。読み取り専用で、個別にレプリケートされ、自分のグラフと並べてクエリできますが、それを介して書き込むことはできません。

テナンシーがアプリケーションの述語ではなくグラフで強制されるため、同じコードベースがマネージド SaaS、専用のシングルテナントデプロイ、完全にセルフホスト可能なインストールをフォークなしで提供します。詳細: Graphs & Multi-Tenancy。

アイデンティティとアクセス

プログラムによるアクセスは X-API-Key を使用し、ブラウザアプリは短命な JWT を使用します。人がどのように_ログインする_かはデプロイの決定事項であり——パスワード、WebAuthn パスキー、またはエンタープライズアイデンティティプロバイダー——GET /v1/auth/providers で公開されるため、単一のフロントエンドビルドがバックエンドに構成された任意の態勢をレンダリングします。

エンタープライズ SSO (OIDC) と SCIM 2.0 プロビジョニングはリポジトリに含まれて出荷され、デフォルトでは無効です——ライセンスゲートなしで任意のフォークが利用できます。プロビジョニングはリンクのみです。SCIM はアカウントを作成し、OIDC はすでにプロビジョニングされたアカウントのみを解決するため、アイデンティティプロバイダーが双方向でアカウントのライフサイクルを所有します。

詳細: Enterprise SSO & SCIM · Authentication & API Keys · SECURITY.md

コンポーネント

アプリケーション層:

• バージョン付きエンドポイントを備えた FastAPI REST API
• Extension GraphQL 読み取り API と名前付き REST コマンド操作 (CQRS)
• AI を活用したグラフデータベースアクセス用の MCP サーバー — すべてのグラフは MCP Streamable HTTP トランスポートを使用し、OAuth または API キー認証に対応
• 自動クレジット追跡を備えた自律的な財務運用のための AI Operator System
• データパイプラインのオーケストレーションとバックグラウンドジョブ用の Dagster

LadybugDB グラフデータベース:

• 財務分析専用に設計された組み込みカラムナーグラフデータベース
• ベース + 拡張スキーマアーキテクチャ — 拡張がドメインモデルを定義
• 高性能なステージングと取り込みのためのネイティブ DuckDB 統合
• セマンティックモダリティエンジンとしての LanceDB — AI メモリ (remember/recall) とベクトル検索のオフロードのための、グラフごとのオンディスクベクトルストア (IVF-PQ、384 次元埋め込み)
• 設定可能なメモリ、レート制限、サブグラフ割り当てを備えた階層型インフラストラクチャ
• 共有階層は読み取りレプリカを備えたパブリックリポジトリをホスト

データ層:

• IAM、グラフメタデータ、Dagster、および拡張 OLTP データベース (テナントごとのスキーマ) 用の PostgreSQL (RDS)
• 全文検索およびセマンティックドキュメント検索 (BM25 + KNN) 用の OpenSearch
• キャッシュ、SSE メッセージング、レート制限用の Valkey (ElastiCache)
• データレイクストレージおよび静的アセット用の S3
• インスタンス/グラフ/ボリュームレジストリ用の DynamoDB

インフラストラクチャ:

• OIDC を使用して GitHub Actions 経由でデプロイされる CloudFormation
• API および Dagster 用の ECS Fargate
• LadybugDB ライタークラスター用の EC2 (ASG)、共有レプリカクラスター用の EC2 (ALB + ASG)

AI

Model Context Protocol (MCP)

• 財務分析: エンタープライズデータとパブリックベンチマークデータにわたる自然言語クエリ
• データベース間クエリ: ユーザーのグラフデータと SEC 共有リポジトリデータの比較
• ツール: グラフクエリ、スキーマイントロスペクション、ファクト探索、財務分析、ドキュメント検索、AI メモリ操作のための豊富なツールキット
• ハンドラープール: リソース制限を備えた管理対象の MCP ハンドラーインスタンス

AI Operator System

• 統一アーキテクチャ: ステートレスな Operators (Claude/MCP エグゼキューター) とプロトコルベースのサービスインジェクション
• デュアル実行: API (同期/SSE) とバックグラウンドワーカー (Valkey キュー + SSE 進捗)
• AI 呼び出しごとの自動クレジット追跡 — Operators は課金を忘れることができません
• 拡張可能: 新しい AI ワークフロー用に新しい Operators を追加できます。実行、クレジット追跡、進捗ストリーミングを自動的に継承します

クレジットシステム

• AI 操作のみ: クレジットは AI Operator 呼び出し (AWS Bedrock 経由の Anthropic Claude) によってのみ消費されます
• トークンベースの課金: 実際のトークン使用量とモデルコストに基づくクレジット
• MCP ツールアクセス: MCP 呼び出しやデータベース操作ではクレジットは消費されません

SEC 共有リポジトリ

SEC EDGAR XBRL 提出書類から取得した、米国の上場企業の財務データを厳選したナレッジグラフです。共有 LadybugDB ティアで稼働し、MCP ツール、Cypher クエリ、AI Operator からアクセスできます。

コーパス全体は、毎月 1 つの LadybugDB ファイルとして Hugging Face でも公開されています — robosystems/sec-xbrl-knowledge-graphs（ダウンロードには数十 GiB、ディスク上では 100 GiB を大きく超えます。各スナップショットの正確なサイズはデータセットカードに記載されています）。just sec-dump を実行すると、パイプラインを実行せずにローカルの Cypher、API、MCP 用に data/lbug-dbs へ取得できます。詳しくは SEC XBRL Pipeline ガイドをご覧ください。

• パイプライン：EDGAR → ダウンロード → 処理（Parquet）→ ステージング（DuckDB）→ エンリッチ（Icebug+fastembed）→ マテリアライズ（LadybugDB）→ インデックス作成 + 埋め込み（OpenSearch）
• グラフ：ベーススキーマと roboledger 拡張 — XBRL 報告階層全体をモデル化する 20 種類のノードタイプと 41 種類のリレーションシップタイプ
• 抽出：すべての提出書類は xbrlkit で解析されます。これは、disclosures と information-block の各ツール、ホロンビューアー、および独自の MCP サーバーを支える、同じオープンライブラリです
• 検索：ナラティブセクションと iXBRL 開示を対象とした、BM25 と KNN ベクトル検索のハイブリッド検索
• エンリッチメント：共有リポジトリの開示情報全体にわたる、セマンティックな要素のマッピング、ステートメントの分類、開示情報のタグ付け

詳しいドキュメントは SEC Adapter をご覧ください。

クライアントライブラリ

RoboSystems は、アプリケーションの構築に役立つ包括的なクライアントライブラリを提供しています。

MCP（Model Context Protocol）

すべてのグラフは MCP サーバーであり、接続にはグラフの URL を使う方法が推奨されます — Claude、Claude Code、Cursor、または HTTP トランスポートに対応する任意の MCP クライアントから、インストール不要で接続できます。URL でグラフを指定します（公開 SEC リポジトリの場合は sec、独自のグラフの場合はグラフ ID）。OAuth でサインインするか、API キーを X-API-Key ヘッダーに指定してください。URL には決して含めないでください。

OAuth — サインインしてグラフを選択します。 グラフを指定しないエンドポイント https://api.robosystems.ai/v1/mcp は OAuth のみを受け付けます。OAuth 対応クライアント（claude.ai、Claude Code、ChatGPT、VS Code、Cursor）がエンドポイントから認可サーバーを検出します。サインインして接続対象のグラフを選択すると、クライアントはそのグラフに紐づく、取り消し可能なトークンを保持します。貼り付けるキーは不要です。グラフごとの URL も、キーのヘッダーと併せて OAuth を受け付けます。（デプロイフラグ：MCP_OAUTH_ENABLED。）

RoboLedger エンドポイント。 https://api.robosystems.ai/v1/mcp/roboledger は、RoboLedger グラフ専用の同じ OAuth フローです。サインイン時に選択できるのは RoboLedger グラフのみで、接続先ではワークスペースおよびプラットフォーム管理ツール（サブグラフ、バックアップ、マテリアライズ、書き込みポリシー）を除いた会計ツールセットを利用できます。RoboLedger のディレクトリ掲載用エンドポイントであり、URL ごとに 1 つのツールリストを固定します。

claude mcp add --transport http robosystems https://api.robosystems.ai/v1/mcp

API キーを使った Claude Code — 次のコマンドを 1 つ実行します。

claude mcp add --transport http robosystems-sec \
  https://api.robosystems.ai/v1/graphs/sec/mcp \
  --header "X-API-Key: <your key>"

Cursor / VS Code — mcp.json に追加します。

"robosystems-sec": {
  "url": "https://api.robosystems.ai/v1/graphs/sec/mcp",
  "headers": { "X-API-Key": "<your key>" }
}

Claude（claude.ai / Desktop） — Settings → Connectors → Add custom connector で https://api.robosystems.ai/v1/mcp（またはグラフごとの URL）を指定します。Claude が OAuth を検出し、サインイン時にグラフを選択できます。アプリの MCP page（/connect）には、選択したグラフ用のすべてのスニペットが入力済みで表示され、ヘッダーのみを使うクライアント向けにグラフ限定のキーを発行できます。

• ドキュメント：AI Operators and MCP | HTTP トランスポートに対応していないクライアント向けの stdio bridge（プロキシモード）

TypeScript/JavaScript クライアント

TypeScript をサポートした、Web および Node.js アプリケーション向けのフル機能 SDK です。

npm install @robosystems/client

• 機能: 型安全な API 呼び出し、自動リトライロジック、コネクションプーリング、ストリーミングサポート
• ユースケース: Web アプリケーション、Node.js バックエンド、React/Vue/Angular フロントエンド
• ドキュメント: npm | GitHub

Python クライアント

バックエンドサービスおよびデータサイエンスのワークフロー向けのネイティブ Python SDK です。

pip install robosystems-client

• 機能: Async/await サポート、pandas 連携、Jupyter 互換性、バッチ操作
• ユースケース: データパイプライン、ML ワークフロー、バックエンドサービス、分析
• ドキュメント: PyPI | GitHub

ドキュメント

技術ドキュメント

はじめに & プラットフォーム:

• ホーム / 概要 · クイックスタート · 中核概念 · アーキテクチャ概要 · ブートストラップガイド · Windows セットアップ (WSL2) · セキュリティ & コンプライアンス

運用レイヤー:

• グラフ & マルチテナンシー · 認証 & API キー · エンタープライズ SSO & SCIM · 分析グラフへのクエリ · グラフ操作 · AI オペレーター & MCP · 共有リポジトリ · クレジット & 請求 · パイプラインガイド

拡張レイヤー:

• 拡張サーフェスの概要 · GraphQL 読み取り · RoboLedger 操作 · RoboInvestor 操作 · QuickBooks をローカルで接続

コンテンツ & コントリビューション基盤:

• 情報ブロック · タクソノミー & フレームワーク · イベント駆動型台帳 · レポーティング & レンダリング · シリアライゼーション & エクスポート

ドキュメント & 検索:

• 検索 & AI 検索取得 · ドキュメント管理 · ファイルアップロード

デモ:

• RoboLedger デモウォークスルー · SEC XBRL パイプライン · カスタムグラフスキーマ

コードベースのドキュメント

各パッケージは自身をドキュメント化しています — そのディレクトリで作業する前に README を読んでください。

コアサービス:

• Adapters - 外部サービス連携
• Operations - ビジネスワークフローのオーケストレーション、拡張機能向けの CQRS 読み取り/コマンドカーネル
• AI Operators - AI Operator フレームワーク: Claude/MCP エグゼキューター、クレジット追跡、SSE ストリーミング
• Schemas - グラフスキーマ定義
• Extensions GraphQL - Strawberry GraphQL の読み取りサーフェス、Pydantic の自動導出、リゾルバーパターン
• Configuration - 構成管理
• Dagster - データパイプラインとタスクのオーケストレーション

データベースモデル:

• Platform Models - プラットフォームデータベース用の SQLAlchemy モデル
• Extensions Models - グラフごとのスキーマテナンシーを持つ拡張機能データベース用の SQLAlchemy モデル
• API Models - コアプラットフォームおよび拡張機能サーフェス向けの Pydantic リクエスト/レスポンスモデル

グラフデータベースシステム:

• Graph API - Graph API の概要
• Client Factory - クライアントファクトリーシステム
• Core Services - コアサービスレイヤー

ミドルウェアコンポーネント:

• Authentication - 認証と認可
• Graph Routing - グラフルーティングレイヤー
• MCP - MCP ツールとプーリング
• Billing - サブスクリプションと課金の管理
• Observability - OpenTelemetry による可観測性
• Robustness - サーキットブレーカーと再試行ポリシー

インフラストラクチャ:

• CloudFormation - AWS インフラストラクチャテンプレート
• Setup Scripts - ブートストラップと構成スクリプト

開発リソース:

• Examples - 実行可能なデモと連携例
• Tests - テスト戦略と構成
• Admin Tools - 管理ユーティリティと CLI

セキュリティとコンプライアンス:

• SECURITY.md - 実装参照付きのセキュリティコントロールカタログ
• Compliance - コンプライアンススタック、トグル、SOC 2 の状況
• Trust Center - ライブのコンプライアンス状況と監査成果物

API リファレンス

• API リファレンス — すべてのエンドポイントと、そのパラメーター、スキーマ、呼び出し例
• インタラクティブ API コンソール — Swagger UI。自身のキーを使ってライブ API に対して呼び出しを実行できます
• OpenAPI 仕様 — 機械可読なソース。SDK ジェネレーターが読み取るものです

サポート

• Issues
• ドキュメント
• プロジェクト
• ディスカッション
• CONTRIBUTING.md — ブランチ規約、コーディング標準、プルリクエストのプロセス

ライセンス

このプロジェクトは Apache License 2.0 の下でライセンスされています - 詳細は LICENSE ファイルを参照してください。

Apache-2.0 © 2026 RFS LLC