Repolode
crmne

crmne/ruby_llm

チャット、ツール、エージェント、埋め込み、Rails連携を単一のAPIで実現する、LLM機能開発向けRubyフレームワーク。

スター
4,497
フォーク
534
未解決の Issue
27
最終コミット
14 時間前

これは何?

RubyLLMは、アプリケーションにAI機能を組み込むためのRubyフレームワークです。OpenAI、Anthropic、Gemini、Ollama、OpenRouterを含む23のモデルプロバイダーと、OpenAI互換のあらゆるエンドポイントに対応する一貫したAPIを提供します。そのため、ホスト型モデルとローカルモデルを切り替えても、アプリケーションコードを書き直す必要はありません。

基本的なチャットに加えて、Rubyのメソッドをモデルから呼び出せるようにするツール呼び出し、再利用可能なエージェント、Rubyのスキーマで定義する構造化出力、ストリーミング、埋め込み、画像・動画生成、文字起こし、音声合成、OCRに対応しています。また、データセットをRSpec、Minitest、Rake経由で実行する評価システムのほか、MCPサーバー接続、プロンプトキャッシュ、フォールバック、試行ごとのコスト追跡機能も備えています。

Railsアプリケーション向けには、会話のActive Recordによる永続化、Active Storageの添付ファイル、Hotwireストリーミング、動作するチャットインターフェースを生成するジェネレーターを提供します。

主な機能

  • 01Ollama経由のローカルモデルやOpenAI互換エンドポイントを含む、23のプロバイダーに対応した統一API。
  • 02Rubyのメソッドをモデルに公開するツール呼び出し。人間による承認も設定可能。
  • 03再利用可能なエージェントと、ステップごとに実行できるエージェントループ。
  • 04Rubyのスキーマによる構造化出力と、レスポンスのRubyオブジェクトへのパース。
  • 05Ruby、RSpec、Minitest、Rakeから実行できる評価。
  • 06Active Recordによる永続化、Hotwireストリーミング、ジェネレーターを備えたRails連携。

ユースケース

  • 会話履歴を保存できるチャットアシスタントをRailsアプリケーションに追加する。
  • 内部のRubyメソッドを呼び出し、質問への回答やアクションの実行を行うエージェントを構築する。
  • 検索・取得パイプラインで埋め込みを生成し、検索結果をリランキングする。
  • 既存のRSpecまたはMinitestスイートの一部として、データセットを使ってLLMのレスポンスをテストする。

クイックスタート

  1. 1

    Bundlerでgemをインストールする

    bundle add ruby_llm --version 2.1.1
  2. 2

    スクリプトでプロバイダーのAPIキーを設定する

  3. 3

    1行のコードで質問する

    RubyLLM.chat.ask "What's the best way to learn Ruby?"

使う前に知っておきたいこと

  • 少なくとも1つのモデルプロバイダーのAPIキーが必要です。
  • 評価機能やコード実行など一部の機能は、安定版ではなくmainブランチでのみ利用できます。

収録されている特集

トピック

よくある質問

ruby_llm とは?
チャット、ツール、エージェント、埋め込み、Rails連携を単一のAPIで実現する、LLM機能開発向けRubyフレームワーク。 RubyLLMは、アプリケーションにAI機能を組み込むためのRubyフレームワークです。OpenAI、Anthropic、Gemini、Ollama、OpenRouterを含む23のモデルプロバイダーと、OpenAI互換のあらゆるエンドポイントに対応する一貫したAPIを提供します。そのため、ホスト型モデルとローカルモデルを切り替えても、アプリケーションコードを書き直す必要はありません。
ruby_llm は無料で使えますか?ライセンスは?
ruby_llm は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
ruby_llm は今もメンテナンスされていますか?
活発にメンテナンス中。ruby_llm の最終コミットは 2026年11月6日 です。
ruby_llm は何に使えますか?
会話履歴を保存できるチャットアシスタントをRailsアプリケーションに追加する。 内部のRubyメソッドを呼び出し、質問への回答やアクションの実行を行うエージェントを構築する。 検索・取得パイプラインで埋め込みを生成し、検索結果をリランキングする。 既存のRSpecまたはMinitestスイートの一部として、データセットを使ってLLMのレスポンスをテストする。
ruby_llm のインストール方法は?
Bundlerでgemをインストールする: bundle add ruby_llm --version 2.1.1 スクリプトでプロバイダーのAPIキーを設定する 1行のコードで質問する: RubyLLM.chat.ask "What's the best way to learn Ruby?"
ruby_llm はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/crmne/ruby_llm

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト