ruby_llm

用 Ruby 优雅地构建 AI 应用，一套代码接入所有主流大模型。

ruby_llm 是一个为 Ruby 语言打造的 AI 框架，旨在统一接入各大主流 AI 提供商（如 OpenAI、Anthropic、Gemini、DeepSeek、Ollama 等），让开发者能用优雅、表达力强的 Ruby 代码构建 AI 代理、聊天机器人、RAG 应用和多模态工作流。它解决了 Ruby 生态中缺乏现代 AI 开发工具的问题，提供了统一的 API 接口，屏蔽了不同提供商之间的差异，支持文本生成、图像生成、嵌入等功能。核心能力包括：多提供商适配、流式响应、工具调用、代理构建、RAG 支持，以及灵活的配置管理。项目活跃，星标 4288，正在成长中。

开源 free 图像生成

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 4400

维护状态活跃

是否开源是

定价模式 free

项目数据

分类图像生成

开发团队crmne

所属国家

官网地址https://rubyllm.com

GitHubhttps://github.com/crmne/ruby_llm

定价模式free

价格说明开源框架，MIT许可证，完全免费，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言Ruby

技术栈/模型agent-framework,agentic-ai,agents,ai,ai-agents,ai-framework,anthropic,embeddings,gemini,generative-ai,large-language-models,llm,multimodal,ollama,openai,rag,rails,ruby,structured-output,tool-calling

GitHub 星标★ 4400

30天Star增速

HF 下载量

上线时间2025-01-30 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数6

使用教程

难度：入门约 10 分钟部署方式：库/依赖 6 步

环境要求

Ruby 环境（gem 由 Bundler 管理）
已初始化的 Ruby 项目；Rails 集成需 Rails 项目
至少一个 AI 提供商的 API Key（如 OPENAI_API_KEY）

安装与启动步骤

1添加 ruby_llm 依赖

在项目目录下用 Bundler 添加 2.0 候选版 gem，README 明确指定版本号 2.0.0.rc2
```
bundle add ruby_llm --version 2.0.0.rc2
```
2设置 API Key 环境变量

配置需要从环境变量读取密钥，此处以 OpenAI 为例，把 sk-xxxxxxxx 换成你自己的真实密钥
```
export OPENAI_API_KEY=sk-xxxxxxxx
```
3编写配置代码

在脚本中或 Rails 的 config/initializers/ruby_llm.rb 中调用 RubyLLM.configure 配置提供商密钥
```
require 'ruby_llm'

RubyLLM.configure do |config|
  config.openai_api_key = ENV.fetch('OPENAI_API_KEY')
end
```
4生成 Rails 集成文件

仅在 Rails 项目中使用，运行生成器写入 ruby_llm 所需文件
```
bin/rails generate ruby_llm:install
```
5执行数据库迁移

Rails 集成需要建表，运行迁移使相关数据结构生效
```
bin/rails db:migrate
```
6加载模型清单

Rails 集成最后一步，加载 ruby_llm 内置的模型数据
```
bin/rails ruby_llm:load_models
```

关键配置

配置项	必填	说明	示例
`openai_api_key`	是	OpenAI 提供商密钥，配置后即可调用其聊天与媒体能力	`ENV.fetch('OPENAI_API_KEY')`
`gemini_api_key`	否	需要文件相关能力时按示例配置 Gemini	`ENV.fetch('GEMINI_API_KEY')`
`xai_api_key`	否	需要视频能力时按示例配置 xAI	`ENV.fetch('XAI_API_KEY')`
`mistral_api_key`	否	需要 OCR 能力时按示例配置 Mistral	`ENV.fetch('MISTRAL_API_KEY')`
`cohere_api_key`	否	需要重排序（reranking）能力时配置 Cohere	`ENV.fetch('COHERE_API_KEY')`

如何确认成功

能正常 require 'ruby_llm' 并按上述方式完成配置且不报错；Rails 下生成文件、迁移和加载模型均无报错即表示集成成功。

常见问题

Q：应该安装哪个版本？

A：README 中给出的安装命令是 2.0 候选版 2.0.0.rc2，直接使用该命令即可，属于发布候选版本。

Q：除了 OpenAI，还支持哪些提供商？

A：README 说明内置共十七个提供商，涵盖 OpenAI、xAI、Anthropic、Google、AWS、本地模型等，还可直接接入任何 OpenAI 兼容端点。

Q：Gemini、xAI、Mistral、Cohere 的密钥要怎么配？

A：按示例需要分别配置：Gemini 用于文件、xAI 用于视频、Mistral 用于 OCR、Cohere 用于重排序，官方 Getting Started 文档在每个示例旁给出了对应设置。

Q：从 1.16 升级需要额外操作吗？

A：如果你的应用使用 1.16，部署 2.0 之前需要先按官方升级指南完成升级。

注意事项

安装命令指定的是 2.0.0.rc2 候选版本，非正式稳定版，生产环境请谨慎评估。
API Key 建议通过环境变量传入，不要把密钥硬编码到仓库代码中。
除 OpenAI 外，Gemini、xAI、Mistral、Cohere 等按需配置，不需要的可以不设。
Rails 集成必须按顺序执行生成器、数据库迁移和模型加载三步。

核心亮点

统一 API 封装，切换提供商只需改配置，无需改业务代码
覆盖主流 AI 提供商（OpenAI、Anthropic、Gemini 等），支持本地模型（Ollama）
支持图像生成、嵌入、RAG 等高级功能，适合多模态场景

不足之处

Ruby 生态 AI 库较少，社区资源不如 Python 丰富
文档/社区待观察

适用场景

快速构建多提供商支持的 AI 聊天机器人
在 Ruby 服务中集成 RAG 知识库问答
开发支持图像生成的多模态工作流

替代项目

langchain.rb、ruby-openai、anthropic-sdk-ruby

项目介绍

ruby_llm 是开发框架领域的开源项目，由 crmne 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（4,400）位列前 10%，在开发框架分类的 795 个项目里位列前 12%。

近 44 天，它的 GitHub 星标从 4,288 增加到 4,400，净增 112。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。MIT许可证，完全免费，无付费版本。从国内网络环境看，可直接访问。

它主要面向的使用场景是：快速构建多提供商支持的AI聊天机器人。同类可对比的替代方案包括 langchain.rb、ruby-openai、anthropic-sdk-ruby。

上一篇：assistant-ui

下一篇：Gemini-API