20231011_LangChainコントリビュートのすゝめ

続・生成AI周回遅れキャッチアップ勉強会！登壇資料

https://minorun365.connpass.com/event/297923/

Transcript

1. LangChain コントリビュートのすゝめ 続・生成AI周回遅れキャッチアップ勉強会 ！ 2023-10-11 @kzk_maeda
2. 自己紹介 Kazuki Maeda 𝕏 @kzk_maeda SRE/DRE @atama plus AWS Community Builders AWS Startup Community Core Member
3. 自己紹介
4. agenda 1. LangChainのOverview 2. LangChainへのContributeの種類 3. 実際にContributeしてみる
5. 今日のGOAL
6. 免責 • 2023/10/09時点でのLangChainのコードや規約 （ v0.0.310）をベースに記載しています • 個人の見解が多分に含まれています
7. LangChainのOverview
8. LangChainとは • 大規模言語モデル（LLM）を利用したアプリケーション作成を支援 するフレームワーク • 実装にはPython版とJavaScript/TypeScript版がある • 第三者のContributionも含めると非常に開発が活発
9. LangChainとは
10. LangChainについて学ぶ ちょうどいい本が出るので こちらで勉強するのがいいかと思います！！
11. LangChainへのContributeの種類
12. 公式のGuideを読む ◉ CONTRIBUTING.mdに期待されるコントリビュートの方法が記載 されているので、そこを読むところから
13. 🙋Getting Help • 環境のセットアップ やlint強制などで詰 まった場合は maintainerに遠慮な く連絡してね！との こと Contributeの種類 󰠁 Contributing Code • Bug Fix, Docsの改 善、機能追加など • “If there's something you'd like to add or change, opening a pull request is the best way to get our attention.” 🚩GitHub Issues • Bug reportや機能 追加要望を出せる • 過去のIssueは Labelingされて整理 されているので、先 にここを眺めると良 さそう
14. 🙋Getting Help • 環境のセットアップ やlint強制などで詰 まった場合は maintainerに遠慮な く連絡してね！との こと Contributeの種類 󰠁 Contributing Code • Bug Fix, Docsの改 善、機能追加など • “If there's something you'd like to add or change, opening a pull request is the best way to get our attention.” 🚩GitHub Issues • Bug reportや機能 追加要望を出せる • 過去のIssueは Labelingされて整理 されているので、先 にここを眺めると良 さそう 今日のFocus Point
15. Q. コードベース、全部読むべき..？ A. そんなことないです 機能ごとにcomponentも実装も細かく分かれて いるので、関連するコードの周辺のみで十分です よくありそうな悩み
16. Q. コミュニケーションが不安.. A. なんとかなります PR数やばいのに、メンテナの方からの レスは結構早いしフランクです （むしろこっちが返信忘れるまで 　あります） よくありそうな悩み
17. Q. 品質水準満たせているか不安.. A. ガードレールがあります linter/formatterはCIでcheck 既存機能であれば、test codeも 割とある印象 メンテナも気づいてFBくれたり よくありそうな悩み
18. Q. LLMの仕組みとかよくわからないので難しそう　.. A. 僕もよくわかってません LangChainはLLMそのものではなく、それを利用するための フレームワークなので、LLM自体の知識よりも、それをどう使うかのア プリケーション実装に重きが置かれているので 多分大丈夫です よくありそうな悩み
19. 実際にContributeしてみる
20. コントリビュートのStep 1. ネタを探す 2. RepositoryをForkし、環境を構築 3. Let's Coding 4. 変更の検証 5. 品質を整えて、Push/PR作成 6. mergeに向けてコミュニケーション
21. コントリビュートのStep 1. ネタを探す 2. RepositoryをForkし、環境を構築 3. Let's Coding 4. 変更の検証 5. 品質を整えて、Push/PR作成 6. mergeに向けてコミュニケーション
22. ネタを探す • Issuesから手頃なBug Reportや機能要望を探し てみる • 使っていて不便に思ったことを自分で直す • ドキュメントを充実させる、typoを直す
23. 自分が欲しいと思った機能をつくる LangChain Japan MeetUp 登壇資料
24. rename漏れ直したり、ローカル環境便利にしたり
25. コントリビュートのStep 1. ネタを探す 2. RepositoryをForkし、環境を構築 3. Let's Coding 4. 変更の検証 5. 品質を整えて、Push/PR作成 6. mergeに向けてコミュニケーション
26. 公式のGuideを読む（再掲） ◉ CONTRIBUTING.mdにローカル環境構築で実施すべきことが記 載されている
27. 環境のベースをつくる • Package ManagerはPoetryが使われているので、Python環境を 合わせる必要がある • CoreとExperimentalというレイヤがある ◦ Core：LangChainの基本的なコード ◦ Experimental：実験的な機能・コード • 変更したコードを試せる環境が別であると便利（後述）
28. コントリビュートのStep 1. ネタを探す 2. RepositoryをForkし、環境を構築 3. Let's Coding 4. 変更の検証 5. 品質を整えて、Push/PR作成 6. mergeに向けてコミュニケーション
29. Let's Coding
30. コントリビュートのStep 1. ネタを探す 2. RepositoryをForkし、環境を構築 3. Let's Coding 4. 変更の検証 5. 品質を整えて、Push/PR作成 6. mergeに向けてコミュニケーション
31. 変更したコードの機能確認 • ローカルcloneしたLangChainをimportして検証できる環境をつく る • いくつか方法があるけど、pathで実装中のlibraryをinstallするの がシンプルで楽
32. 変更したコードの機能確認 • jupyter notebookなどで新旧コードの挙動を確認
33. コントリビュートのStep 1. ネタを探す 2. RepositoryをForkし、環境を構築 3. Let's Coding 4. 変更の検証 5. 品質を整えて、Push/PR作成 6. mergeに向けてコミュニケーション
34. 品質を整える • Formatter/Linterはmakefileに用意されているので通す • 機能追加やBug Fixの場合、Test Codeを書く • Testもmakefileに用意されているので通す
35. PRを作成する • PR Templateが用意されているので、基本的に則る 前はPR作成時に、PRの種類によって 誰にmentionすべきかのガイドがあっ たのですが、最近それがなくなったの でよりPR作成しやすくなりました
36. コントリビュートのStep 1. ネタを探す 2. RepositoryをForkし、環境を構築 3. Let's Coding 4. 変更の検証 5. 品質を整えて、Push/PR作成 6. mergeに向けてコミュニケーション
37. mergeに向けてコミュニケーション • 特に疑義のない変更であれば、スッとmergeしてくれる
38. mergeに向けてコミュニケーション • 後方互換性の維持など、注意が必要な場合、指摘に対してディ スカッションしたりすることも必要
39. まとめ
40. まとめ • LangChainは非常に変化の激しいライブラリで、色々なものが途 上なのでContributeしやすいです • 自分が使っていて「こうだったらいいのにな」を実現しやすい環境 かなと思います • ぜひContributeしてみましょう！！