RubyLLM：美观框架支持主流AI供应商，两分钟构建可用Ruby AI聊天应用！
链接与版本信息
- RubyLLM
- GitHub
- 更新日志
- 博客
当前最新版本为1.16.0，下一版本 (2.0 开发版) 也在开发中，更新日志 ↗ 可查看详细信息。
快速开始指引
- 快速开始
- 概述
- 配置
核心特性展示
- 聊天
- 工具
- 流式响应
- 嵌入向量
- 图像生成
- 智能体
- 音频转录
- 内容审核
- 深度思考
高级功能介绍
- Rails 集成
- 异步扩展
- 错误处理
- 模型注册表
- 监控
- 智能体工作流
- 升级
参考文档说明
- 可用模型
- RubyLLM 生态系统
本网站使用了 Just the Docs，这是一个适用于 Jekyll 的文档主题。
RubyLLM 简介
RubyLLM 是一个美观的 Ruby 框架，支持所有主流 AI 供应商。借助它，能轻松构建聊天机器人、AI 智能体、RAG 应用、内容生成器，以及各种能想到的 AI 工作流。你可以 开始使用，也能访问其 GitHub 了解更多。
它还在经过实战检验，是完全私密的工作 AI。
两分钟构建可用应用
在短短两分钟内，就能构建一个可用的 Ruby AI 聊天应用。它支持众多 AI 供应商，如 Anthropic、AzureAI、Bedrock、DeepSeek、Gemini、GPUStack、Mistral、Ollama、OpenAI、OpenRouter、Perplexity、VertexAI、xAI 等。
如果你正在使用 RubyLLM，分享你的故事！只需 5 分钟。
选择 RubyLLM 的理由
每个 AI 供应商都提供了臃肿的客户端，有着不同的 API、响应格式和使用规范，让人疲惫。而 RubyLLM 为用户提供了一个统一且美观的框架，无论使用的是 GPT、Claude 还是本地的 Ollama，接口都是一样的。它仅依赖三个库：Faraday、Zeitwerk 和 Marcel，十分简单。
代码示例呈现
# 直接提问
chat = RubyLLM.chat
chat.ask "学习 Ruby 的最佳方法是什么？"
# 分析任意文件类型
chat.ask "这张图片里有什么？", with: "ruby_conf.jpg"
chat.ask "这个视频里发生了什么？", with: "video.mp4"
chat.ask "描述一下这次会议", with: "meeting.wav"
chat.ask "总结这份文档", with: "contract.pdf"
chat.ask "解释这段代码", with: "app.rb"
# 同时处理多个文件
chat.ask "分析这些文件", with: ["diagram.png", "report.pdf", "notes.txt"]
# 流式响应
chat.ask "讲一个关于 Ruby 的故事" do |chunk|
print chunk.content
end
# 生成图像
RubyLLM.paint "一幅水彩风格的山间日落图"
# 创建嵌入向量
RubyLLM.embed "Ruby 优雅且富有表现力"
# 音频转录为文本
RubyLLM.transcribe "meeting.wav"
# 内容安全审核
RubyLLM.moderate "检查这段文本是否安全"
# 让 AI 使用你的代码
class Weather < RubyLLM::Tool
desc "获取当前天气"
def execute(latitude:, longitude:)
url = "https://api.open-meteo.com/v1/forecast?latitude=#{latitude}&longitude=#{longitude}¤t=temperature_2m,wind_speed_10m"
JSON.parse(Faraday.get(url).body)
end
end
chat.with_tool(Weather).ask "柏林的天气如何？"
# 定义一个带有指令和工具的智能体
class WeatherAssistant < RubyLLM::Agent
model "gpt-5-nano"
instructions "简洁明了，始终使用工具查询天气。"
tools Weather
end
WeatherAssistant.new.ask "柏林的天气如何？"
# 获取结构化输出
class ProductSchema < RubyLLM::Schema
string :name
number :price
array :features do
string
end
end
response = chat.with_schema(ProductSchema).ask "分析这个产品", with: "product.txt"特性详细罗列
-聊天：使用 `RubyLLM.chat` 实现对话式 AI
-视觉：分析图像和视频
-音频：使用 `RubyLLM.transcribe` 转录和理解语音
-文档：从 PDF、CSV、JSON 等任意文件类型中提取信息
-图像生成：使用 `RubyLLM.paint` 创建图像
-嵌入向量：使用 `RubyLLM.embed` 生成嵌入向量
-内容审核：使用 `RubyLLM.moderate` 确保内容安全
-工具：让 AI 调用你的 Ruby 方法
-智能体：使用 `RubyLLM::Agent` 创建可复用的助手
-结构化输出：JSON 模式轻松生效
-流式传输：使用代码块实现实时响应
-Rails：通过 `acts_as_chat` 实现 ActiveRecord 集成
-异步：基于 Fiber 的并发处理
-模型注册表：支持 800 多种模型，具备能力检测和定价功能
-深度思考：控制、查看和持久化模型推理过程
-供应商：支持 OpenAI、xAI、Anthropic、Gemini、VertexAI、Bedrock、DeepSeek、Mistral、Ollama、OpenRouter、Perplexity、GPUStack 以及任何 OpenAI 兼容的 API
安装步骤说明
在你的 `Gemfile` 中添加：
gem 'ruby_llm'
然后运行 `bundle install`。
配置你的 API 密钥：
# config/initializers/ruby_llm.rb
RubyLLM.configure do |config|
config.openai_api_key = ENV['OPENAI_API_KEY']
end
Rails 集成操作
# 安装 Rails 集成
bin/rails generate ruby_llm:install
bin/rails db:migrate
bin/rails ruby_llm:load_models # v1.13+
# 添加聊天界面（可选）
bin/rails generate ruby_llm:chat_ui
class Chat < ApplicationRecord
acts_as_chat
end
chat = Chat.create! model: "claude-sonnet-4"
chat.ask "这份文件里有什么？", with: "report.pdf"
访问 `http://localhost:3000/chats` 即可使用现成的聊天界面！
开发者信息
由 Carmine Paolino 开发，他也是的开发者，这是完全私密的工作 AI。
本网站使用了 Just the Docs，这是一个适用于 Jekyll 的文档主题。