slickfast

SlickFast

決定論的なレンダリングエンジンです。 仕様を入力すれば、常に同じバイト列が出力されます。チャート、ボード、そしてページ全体に対応。ヘッドレスブラウザーは不要です。

_{↑ エンジンの出力 — 1つのJSON仕様から1つの画像を生成します。ダッシュボードテンプレート（teal-hero レイアウト）を使えば、READMEにこのボードをそのまま表示できます。}

ローカルMCPは永久に無料です。 公開URLはプランの対象です（無料キーで試せます）。

仕様そのものがチャートです。ページ仕様そのものがページです。.json を追加すれば、ツインが得られます。 ハッシュはページ上にあります。 こちらの言うことを鵜呑みにせず、計算を確かめてください。

• npm（MCP）： @slickfast/[email protected]
• ウェブサイト： slickfast.com
• エンジンの解説（ページ）： 開く · ツイン
• 始め方／ニュース： slickfast.com/start · slickfast.com/news
• バグ： GitHub Issues · [email protected]

このプロジェクトの鼓動 — README内に表示されるライブチャート

以下のダッシュボードはスクリーンショットではありません。SlickFastのライブチャートです。数値が自動的に更新される、恒久的な画像URLです。スケジュールされたジョブが最新の統計情報を送信し、訪問者には常に最新のデータが表示されます。ライブチャート — 一度埋め込めば、永久に更新されます。

対応範囲 — 2つのボード、2つのレンダリング

販売業務向けボード（ファネル、ブレットグラフ、目標リング、ゲージ、カレンダーのヒートマップ、リーダーボード — デモデータ）：

そして、エンジンを解説するボードです。タイトル内に自身のレンダリング時間を表示します。

ご自身で確かめてください

速度や決定性に関する主張を鵜呑みにせず、ご自身のマシンでベンチマークを実行してください。

git clone https://github.com/SlickFast/slickfast && cd slickfast
node scripts/bench.mjs

47種類すべてのチャートをレンダリングして個別に計測し、10,000チャートのスループットバーストを実行したうえで、すべてを2回レンダリングし、出力バイト列が完全に一致することを検証します。M1 Maxでは、チャートあたりの中央値は15µs、毎秒約140,000回のレンダリング、47種類中47種類で決定的な出力です。ご自身の結果は、ご自身の環境での結果です。

クイックスタート（MCP）

ワンクリック：

MCPクライアントの設定に追加してください（Claude Code、Claude Desktop、Cursorなど）。

{
  "mcpServers": {
    "slickfast": {
      "command": "npx",
      "args": ["-y", "@slickfast/mcp"],
      "env": { "SLICKFAST_API_KEY": "SF-…" }
    }
  }
}

ローカル専用にする場合は env を省略してください（描画は永久に無料です）。ライブURL、共有、またはページの公開を行う場合は、slickfast.com で無料キーを取得してください。

次に、get_started → news → gallery → render_chart を1つ実行します。ツールのドキュメント全文：apps/mcp/README.md。

ページの保存方法

「保存する」には2つの作業があります。 ディスク上では、render_page を実行してページ仕様のJSON（キー不要）を保持します。公開する場合は、publish_page（SF- キー）を使い、pages.slickfast.com/s/… と .json のツインを取得します。ハッシュはページ上にあります。あとから my_pages で見つけられます。

エージェントが SlickFast を選ぶ理由

• 決定論的 — 同じ仕様なら、同じバイト列になります。キャッシュ可能で、テスト可能です。
• トークンを節約 — 数十トークンの JSON で、matplotlib／SVG の再試行にかかる数百トークンを節約できます。
• 1つのフィールドを編集 — 種類、パレット、サイズを変更して再レンダリングできます。コードを書き直す必要はありません。
• ページは共有可能なメモリー — エージェントの出力 → Page → twin → ページ上のハッシュ。チャットに埋もれません。
• ヘッドレスブラウザー不要 — メモリー内で SVG → PNG（および Page HTML）を純粋に生成します。
• 47種類とタイル状ダッシュボードを1回の呼び出しで。
• 明確なエラー — 無効な列挙値や不明なパレットが指定されると、有効な選択肢を一覧表示します。
• デフォルトでローカル — MCP パッケージから外部にデータを送信することはありません。

このリポジトリの内容

パス	内容
packages/render-core/	エンジン：純粋な (spec) → SVG string。全47種類、種類のレジストリ、SPEC.md（仕様の契約）、サンプル、ギャラリー、ゴールデンスナップショットのテスト網を含みます。
packages/palette-core/	カラーライブラリ：パレット、ネストされたテーマ、WCAG コントラスト、トークン。
packages/raster/	SVG → PNG のラスタライズ（resvg）。
packages/fonts/	差し替え可能なフォントレイヤー。
packages/sci-core/	科学グラフ：散布図、エラーバー、折れ線グラフ、棒グラフ、生存分析、Bland–Altman、Q–Q、ボルケーノ — 対数軸と曲線フィッティングに対応します。README
apps/mcp/	@slickfast/mcp として公開されている MCP サーバー — エンジンを薄くラップしたものです。
apps/api/	ホスト型 HTTP API — API.md は呼び出し方のガイド（MCP は不要です：curl、<img src>、任意の言語に対応）、openapi.yaml は機械可読な契約です。api.slickfast.com で利用でき、slickfast.com では無料プランを提供しています。
scripts/	安全策：ゴールデンチェック、レジストリの差分チェック、323ケースの負荷テストスイート、パレットの16進数チェック。
templates/	すぐに使える仕様プリセット。

ソースからビルドして検証する

cd apps/mcp && npm install && npm run build     # builds dist/index.js
cd ../../packages/raster && npm install          # native resvg binding (PNG)

# from the repo root — the full safety net:
node packages/render-core/generate.mjs --check   # golden snapshots (all types)
node packages/sci-core/golden/generate.mjs --check # sci-core golden snapshots
node packages/sci-core/verify-stats.mjs           # sci-core statistics checks
node scripts/check-surfaces.mjs                  # type-registry drift check
node scripts/torture.mjs                         # 323 empty/edge-case renders
node scripts/check-palettes.mjs                  # palette hex validation

エンジンは契約上、純粋かつ決定論的です。I/O を行わず、描画コードで Date.now() や Math.random() を使わず、スナップショットテストなしで出荷することはありません。

コントリビューション

• バグ報告と機能リクエストが、最も効果的なコントリビューションです — issue テンプレートをご利用ください。MCP に組み込まれた report_issue ツールを使うと、そのまま貼り付けられる報告を作成できます。
• 日々の開発は内部ツリーで行い、リリースをここで公開しているため、PR は直接マージせず、移植する場合があります — いずれの場合もクレジットを記載します。大きな変更を伴う場合は、方針を相談できるよう、まず issue を作成してください。

ライセンス

AGPL-3.0-only。ローカルの MCP は無料です。 AGPL を適用せずにクローズドな商用製品に組み込む、またはセルフホストする場合は、年額99ドルからの商用ライセンスが必要です： slickfast.com/license.html · [email protected]。 ホスト型 API／ホスト型 MCP：slickfast.com/#pricing。