---

OpenTakeoff は、建築図面から数量を測る — 拾い出し（takeoff）のための、無料のオープンソース キャンバスです。他と違うのは「誰が動かせるか」です。人または AI エージェントが、同じエンジンを 動かします。部屋の内側をクリックすれば輪郭が自動でトレースされ、エージェントは MCP 経由で 同じツールを呼び、同じ数値を得ます。そしてすべての計測値がどう作られたかを記録します — 縮尺、ワンクリックか手描きか、人が引いたかエージェントが引いたか。根拠が数値と一緒に流通します。

これまで、ウェブベースのオープンソース拾い出しキャンバスは存在しませんでした — 内装・床仕上げ 向けのものは言うまでもなく。OpenTakeoff がそれです。業界に無償で提供される、本物の代替ツールです。

もともとは商用の床仕上げ積算アプリの拾い出しモジュールでした。それを切り出し、整理し、公開したものです。 これはデモではなく、実際の計測エンジンです — 月額 $300 のツールがサブスクリプションの 向こう側に隠している塗りつぶし式の部屋トレーサー One-Click Area を含みます。

メートル法に対応しています

日本の図面でそのまま使えます。m² / m 表記と 1:50・1:100 形式の縮尺をネイティブに サポートし、シートごとに縮尺を記憶します（図面セットの縮尺が全ページ均一であることは、まずないため）。 インチ・フィート系との切り替えも可能です。

ただし、アプリの UI は現在英語のみです

正直にお伝えします。計測・数値・出力はすべて言語に依存しませんが、ツールバーとメニューの ラベルは現時点で英語のみで、UI の翻訳レイヤーはまだありません。図面を読んで数量を出す作業自体は 問題なく行えますが、ボタンの文言は英語です。日本語 UI をご希望の場合は Issue でお知らせください — 需要が見えれば着手します。

クイックスタート

使うだけならインストールは不要です — ライブデモを開いて、 図面をドラッグするだけです。

自分で動かす場合:

cd web
npm install
npm run dev        # http://localhost:5173

demo/sample-plan.pdf をキャンバスにドラッグしてください。縮尺は自動検出されます。 条件（コンディション）を選び、One-Click Area を押して部屋の内側をクリックします。 Report を開くと内訳が表示され、CSV / JSON でエクスポートできます。

主な機能

領域	内容
取り込み	PDF・画像・.zip 図面セット — ブラウザ内で展開、複数ページ対応、最大 4 シートを並べて表示
縮尺	図面上の縮尺記載を自動検出、または既知寸法から校正 — シートごとに保持
計測	One-Click Area（塗りつぶし式）、面積、矩形、長さ、壁面積、カウント、控除（デダクト）、ゾーン別集計 — メートル法／ヤード・ポンド法
作図補助	45°／90° 角度ロック（⇧ で強制ロック）、カーソル位置に角度と線分長をライブ表示、端点スナップ（beta）
条件（コンディション）	仕上げごとの色＋ CAD ハッチパターン、ロス率、×N 倍率、壁高さ、厚み → 見切り・framing の面積換算
副資材	施工方法・下地種別、および接着剤・シーラー・ウレタン・モルタル・目地材などの副資材を、被覆率（塗布量）から必要数量へ自動換算（切り上げ）
レポート	条件別の床／壁／見切り面積、長さ、個数、ロス込み・ロス抜き＋資材発注リスト
エクスポート	CSV、JSON、Excel（.xlsx）、印刷、マークアップ済み PDF（図面＋描き込み＋凡例表紙をブラウザ内で生成）
改訂管理	入札改訂ごとに拾い出しを保存し、差分を比較 — 条件別・シート別・発注リスト別の数量差分
マークアップ	雲マーク、引き出し線、テキスト注記 — 別レイヤーで、数量には一切含まれません
表示	ライト／ダーク（ネガ表示） — CSS フィルタではなく、図面ピクセル自体を描画時に反転
保存	IndexedDB + localStorage — 完全クライアント側、アップロードなし
MCP サーバー	MCP クライアントから stdio でエンジンを操作 — 図面を読み込み、縮尺を設定し、部屋をワンクリックし、拾い出しを書き出す（mcp/）
出所記録	すべての図形が、どう計測されたかを記録 — 縮尺、ワンクリックか手描きか、人かエージェントか
デプロイ	静的ビルド一つ。Netlify、Vercel、GitHub Pages、S3、任意の静的ホストで動作

AI エージェントから使う

同じエンジンが MCP を話します。mcp/ は MCP クライアントから駆動できる stdio サーバーで、コマンド一つで動きます — npx -y opentakeoff-mcp。 load_plan、read_sheet_text、set_scale、one_click、view_sheet、takeoff_summary、 export_takeoff などを提供します。

エージェントは図面を開き、表題欄を読み、縮尺を採用し（黙って適用されることはありません）、 部屋をクリックし、校正済みの計測グリッド付きレンダリング（view_sheet）で自分の作業を検証し、 アプリが自動保存するのと同一のペイロードを書き出します — 同じ計算、同じ出所記録、同じ縮尺ゲート。 セットアップと実際の対話例: docs/MCP.md

データはあなたのものです

図面・縮尺・条件・マークアップは、すべてあなたのブラウザに自動保存されます （IndexedDB + localStorage）。アップロードは発生せず、アカウントもなく、デフォルトビルドには サーバーが存在しません。静的ビルドを自分でホストすれば、その状態が維持されます。 音声入力を使う場合も、音声認識はブラウザ内のオンデバイスで行われ、音声がマシンから出ることはありません。

背景にある研究

OpenTakeoff は、自分の部署が使う AI を自分で作っている現役の商業床仕上げ積算担当者が運営する、 応用研究プログラム（Kentucky AI）の「開かれた半分」です。 境界線は意図的なもので、優れたオープンコア科学ソフトウェアが引くのと同じ線です — 計測エンジン（レンダリング、縮尺、ジオメトリ、エクスポート、MCP サーバー）は AGPL-3.0 で オープンなまま。自社の積算アーカイブで学習させた AI モデルは専有。 シートライセンス不要の実用ツールが手に入り、私たちは自分たちのデータでしか作れない部分を保持します。

公開済みの研究成果物（モデルカード、ベンチマーク仕様、論文）: Hugging Face · kentucky-ai.com

この上に作る

OpenTakeoff は AGPL-3.0 です。フォークし、変更し、出荷してください — 自分のチームのためでも、 自分のプロダクトの土台としてでも。コードベースは意図的に小さく読みやすく保たれています:

• ジオメトリと計測 — web/src/lib/oneclick.ts、web/src/lib/sheets.ts（型付き・テスト済み）
• 集計と資材計算 — web/src/lib/totals.js
• 状態と永続化 — web/src/lib/store.js
• UI — web/src/pages/TakeoffCanvas.jsx、web/src/components/

PR の前に npm run typecheck && npm test && npm run build を実行してください。ジオメトリ ライブラリは純粋関数のまま・テスト付きで保ち、実案件の図面は決してコミットしないでください。 CONTRIBUTING.md とユーザーガイドを参照してください。

コントリビューションを歓迎します。 Issue や PR は日本語で書いていただいて構いません — こちらで 翻訳して対応します。good first issue ラベルの付いた課題は小さく、仕様が明確で、該当ファイルまで示してあります。 テスト付きで CI が緑の PR は速くマージされます。

技術スタック

• フロントエンド: React 18 + Vite（プレーン JSX）
• 描画: 生の HTML5 Canvas + SVG（描画フレームワークなし）
• ジオメトリ: TypeScript（oneclick.ts、sheets.ts）
• PDF レンダリング: pdf.js
• 図面セット取り込み: fflate（zip）+ pdf-lib（画像 → PDF）、遅延ロード
• 保存: IndexedDB + localStorage — バックエンド不要
• テスト: node --test + tsx
• 有償依存なし。 THIRD-PARTY-NOTICES.md を参照。

ステータス

OpenTakeoff はプレビューではなく、実際に使われているツールです。計測エンジン — One-Click Area、条件、副資材、レポートとエクスポート — は、商用の床仕上げ積算アプリから 切り出された製品版エンジンです。Snap は beta 扱いです。実際の商業床仕上げ入札で使われています。

ライセンス

GNU Affero General Public License v3.0（AGPL-3.0-only）— 使い、フォークし、出荷し、この上に作ってください。 改変版を他者に提供する場合（ホスティングを含む）は、同じライセンスで変更を公開してください。 コミット 84c7f48e（タグ apache-2.0-final）までは Apache-2.0 で、そのコードは引き続き Apache-2.0 です。 帰属表示については NOTICE を参照してください。

---

この日本語版について。 正典は英語版の README.md です。この翻訳は要約版であり、 最新の機能追加が反映されるまで時間差が生じることがあります。相違がある場合は英語版が優先されます。 完全な機能一覧は FEATURES.md、変更履歴は CHANGELOG.md を参照してください。 翻訳の誤りを見つけたら、Issue や PR で指摘していただけると助かります。