no-magic-ai/no-magic

解決する課題

no-magic は、機械学習教育における高レベルなライブラリ呼び出し（model.fit() など）と、難解な学術論文との間のギャップを埋めるものです。現代のフレームワークによる抽象化層を排除し、読みやすく透明なコードとして実装することで、AIアルゴリズムの内部メカニズムを理解する方法を提供します。

仕組み

このプロジェクトは、厳選された単一ファイルのPythonスクリプト集で構成されています。各スクリプトは、Python標準ライブラリのみを使用して特定のAIアルゴリズムをゼロから実装した、完全かつ実行可能なプログラムです。ほとんどのスクリプトは、モデルのゼロからの学習と推論というライフサイクルに従っていますが、比較や学習を伴わないメカニズムに焦点を当てたものもあります。これらの実装は、GPUや外部依存関係を必要とせず、標準的なノートPCのCPUで高速に動作するように設計されています。

対象読者

• MLエンジニア: 使用しているフレームワークの内部構造を理解したい方。
• 学生: 理論から実践へ移行し、アルゴリズムが実際に動作するコードとして見たい方。
• キャリアチェンジを目指す方: ML APIの背後にあるプロセスへの直感が必要な方。
• 研究者: フレームワークのオーバーヘッドなしでプロトタイピングを行うための最小限の参照実装を探している方。

ハイライト

• ゼロ依存関係: Python標準ライブラリのみを使用し、pip install は不要です。
• 1ファイル、1アルゴリズム: すべての実装が単一のスクリプトに完結しています。
• CPU最適化: ノートPCのCPUで数分以内に実行できるように設計されています。
• 幅広いカバー範囲: GPT、BERT、Diffusion、LoRA、PPO、Flash Attention、ReAct agents の実装が含まれています。
• 教育的焦点: コード行数の最適化よりも、読みやすさを優先しています。