Nutlope/bygga

IKEA assembly, step by step: animated, manual-style 3D guides. Scan any paper manual with Together AI.

Bygga — 3D で生成される IKEA 組み立てガイド

概要: usebygga.com の Web アプリで、IKEA の箱に記載された名前や品番(BISSA や MALM など)を入力すると、3D 線画で描かれた完全な組み立てガイドが表示されます。紙のマニュアルと似ていますが、任意の角度から見ることができ、各ステップが音声で読み上げられます。

仕組み

Bygga は IKEA の PDF マニュアルを使用しません。代わりに、IKEA の公開製品リストからデータを取得し、パラメトリックなプラン生成器を使ってすべてのガイドを独自に生成します。現在、1,171 の IKEA 製品(英国および米国シリーズで 2,180 サイズ)をカバーし、すべて three.js のラインアートエンジンでオフライン描画されます。

音声コントロール

このアプリはハンズフリー対応です。1,476 の録音済みオーディオクリップ(Kokoro という音声を使用)が含まれており、API キーなしで再生できます。また、Together AI 上で動作する Whisper(音声認識システム)を使用して「next」という単語を聞き取り、オーディオ再生中でも聞き取れるようにエコーキャンセリング機能を備えています。

AI 支援

カタログにない製品や、写真検索、ヘルプが必要な場合、訪問者は自分の Together AI API キーを入力できます。AI は以下を実行できます:

  • カタログにない製品の組み立てガイドの下書き
  • 写真からの製品検索
  • 正確なパネル、金具、ステップの図を使って質問に回答

その他の機能

  • 共有カード:同じ 3D エンジンで描画
  • A4 印刷ビュー:紙のガイド用
  • オフライン対応:service worker により、開いたガイドは電波がなくても動作
  • ビルドページ:完成したすべてのビルドを実寸で並べて表示

ローカルでの実行

リポジトリをクローンし、npm install、npm run dev を実行して、localhost:3000 を開き、BISSA と入力して試してください。URL(例:/build/malm-3-drawers?step=12)で特定のステップにジャンプしたり、/build/malm-3-drawers/print で印刷、/builds で完成したビルドを確認できます。AI 機能を使用するには、.env.example を .env.local にコピーし、TOGETHER_API_KEY を設定し、アプリのキーボックスにモックキーを貼り付けます(モックキーを受け入れるのは npm run dev のみです)。

テスト

2 つのテストスイートが含まれています:npm run voice:check は 283 回の録音済みリスニング実行を再生し、npm run ikea:check はすべてのカタログ行をテストします。

ロードマップ

計画中の改善:

  • 変形形状(三角棚、コーナー組み合わせ、特定の PAX 幅)を処理できるようにジェネレーターを改良
  • 音声の言語を追加
  • 実際のマニュアルで手動スキャナー機能をテスト

ライセンスと商標

MIT ライセンスですが、IKEA とは提携していません。IKEA およびその製品名は Inter IKEA Systems B.V. の商標であり、ライセンスはそれらに対する権利を付与しません。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト