Best of AIがオープンソースになりました！

Best of AIは約1年前、使う価値のあるAIツールを選んで紹介するディレクトリとして始まりました。今日、データ、サイト、スクリプト、CIを含むすべてをGitHubでオープンソースとして公開しました 。これからはコミュニティと一緒に運営していきます。

フラットファイル、データベースなし

各ツールはcontent/tools/にあるMarkdownファイルです。カテゴリはdata/categories.yamlにあります。ランキング はdata/leaderboard.yamlからツールを並べます。PostgresもヘッドレスCMSも、ベンダーロックインもありません。リポジトリをクローンし、必要な情報をgit grepで探し、誤りがあればプルリクエストを送る。それが運営の仕組みです。

サイトはHugo による静的ビルドです。HTML、CSS、少量の素のJavaScriptで構成しています。mainにプッシュするとGitHub Actionsがhugo --minifyを実行し、成果物をGitHub Pagesに公開します。管理するサーバーはありません。

面倒な作業はGitHub Actionsに任せる

知っておくとよいワークフローは3つです。

• デプロイ — mainへのプッシュごとにビルドして公開します
• Issueからプルリクエストへ — 正しいテンプレートでツールの投稿Issueを開くと、issue-review.pyが内容を検証し、ブランチを作成してプルリクエストを出します
• README更新 — データが変わるたびに、ツールファイルからREADME.mdを再生成します

ツールはIssueまたはプルリクエストで投稿できます。説明の修正はMarkdownファイル1つを編集するだけです。ランキングへの異議や提案はdata/leaderboard.yamlを編集して示せます。すべてGitで確認でき、履歴にも残ります。

ランキング、職種、その他

ランキング は、人気だけでなく、本当に優れていると考えるツールを選んだ一覧です。順位は感覚ではなくデータで管理しています。YAMLを編集してプルリクエストを開き、理由を説明してください。

職種ページ では、開発者、デザイナー、マーケター、ライターなど200以上の職種ごとにツールをまとめています。職種ファイルにカテゴリのslugを記載すると、Hugoが該当するツールを自動で読み込みます。職種の追加もツールと同じです。Markdownファイルを作り、プルリクエストを送れば完了です。

検索はブラウザー内で動きます。ヘッダーの検索モーダルは、ビルド時に作成したJSONインデックス/index.json を読み込みます。データをフォークして独自のUIを作り、好きなものに接続できます。APIキーは不要です。

開発に参加する

Gitで管理するディレクトリ、自動デプロイされる静的サイト、誰でも修正を送れるディレクトリが好きなら、ぜひ参加してください。

• 貢献する — ツールの投稿、掲載内容の修正、ランキングの改善方法
• GitHubリポジトリ — クローンして、変更し、修正して、プルリクエストを送れます

ディレクトリは無料で閲覧できます。コードとデータは自由にフォークできます。1人が門番をするより、100人でリストを改善したいと考えています。