markitai

Markitai

Markitai は、ドキュメント、ウェブページ、画像を Markdown に変換します。単一の Rust コアにより、markitai コマンド（エイリアスは mkai）、ブラウザーワークスペースを備えたローカル REST サービス、MCP サーバー、プロセス内で動作する Node.js、Python、Go のバインディングを提供します。CLI 実行ファイルに Python、Node.js、Go のランタイムは不要ですが、言語バインディングにはそれぞれの言語ランタイムが必要です。

Markitai 2.0 は、Python 版 markitai 1.2 を Rust で書き直したものです。変更履歴と互換性契約をご覧ください。

インストール

macOS および Linux：

curl -fsSL https://markitai.dev/setup.sh | sh

Windows（PowerShell）：

powershell -ExecutionPolicy ByPass -c "irm https://markitai.dev/setup.ps1 | iex"

セットアップスクリプトは、GitHub Releases からお使いのマシン用のリリースアーカイブをダウンロードし、リリースの SHA256SUMS と照合して検証したうえで、管理者権限なしで現在のユーザー向けに markitai、mkai、markitai-mcp をインストールします。リリースは macOS 11 以降（Apple シリコン、Intel）、glibc 2.28 以降の Linux（x86-64、ARM64）、Windows（x64、ARM64）に対応しています。Python ユーザーは、代わりに pip install markitai または uv tool install markitai（Python 3.10 以降）を実行できます。PyPI にはこれら6つのプラットフォーム向けのホイールのみがあり、1.x はもうありません。それ以外の環境では pip にインストール可能なものがなく、インストール済みの 1.x はそのまま残ります。手動ダウンロード、更新、アンインストール、1.x への復帰については、インストール手順をご覧ください。

アーカイブには、ライセンス表示とオフラインで使える厳選された Markdown ガイドが含まれています。OCR モデル、Chromium、LibreOffice は別途導入できるオプションのコンポーネントです。要件についてはプラットフォームのサポート、Gatekeeper については署名されていない macOS ビルド、言語パッケージについてはバインディングをご覧ください。

クイックスタート

markitai report.docx -o out/                  # writes out/report.docx.md
markitai ./documents -o out/                  # whole folder, with a report
markitai scan.png --ocr -o out/               # local OCR; models may need preparation
markitai report.docx -o out/ --json           # structured result for automation
markitai doctor                              # inspect optional components
markitai --help                              # commands, options and examples
markitai serve                               # browser workspace on 127.0.0.1:3600

別個の試用環境を使うには、CLI を使う前に MARKITAI_HOME を設定します：export MARKITAI_HOME="$PWD/.local/try-home"。通常のドキュメント変換にはモデルへの接続は不要です。既存の設定は引き続き適用されます。モデルによる拡張を使わずにローカルでドキュメントを処理するには、--no-llm -b native を使います。URL 入力には、--no-remote-fetch を指定してもネットワークが必要です。ローカル OCR ではすべてのプラットフォームでポータブルな Paddle エンジンを使います（macOS では MARKITAI_OCR_BACKEND=vision を指定すると Vision を使います）。オフラインで使う前に、不足している Paddle モデルを doctor --fix で準備できます。JavaScript ページには Chrome/Chromium が必要です。Office ページ画像には LibreOffice が必要です。モデルによる拡張（--llm）では、設定済みプロバイダーの認証情報またはサブスクリプションのランタイムを使います。

ドキュメント

• クイックスタート：インストールと最初の10のタスク。
• CLI と MCP：コマンドとエージェントの契約。
• エージェントインデックス と スタンドアロンのエージェントガイド：プレーンな Markdown のエントリーポイント。CLI アーカイブにも含まれています。
• ドキュメントインデックス：ソースチェックアウトに含まれるすべてのドキュメント。オフラインアーカイブには厳選されたガイドが含まれますが、その他のトピックへのリンクにはこのリポジトリのチェックアウトが必要です。

ライセンス

MIT。詳しくは LICENSE と NOTICE をご覧ください。