RubyLLM is a Ruby framework that unifies multiple AI providers via a single interface for chats, tools, agents, RAG, and Rails integration. It supports concurrent tool execution, image/video/audio handling, embeddings, moderation, and a Rails-oriented development experience.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
RubyLLM is a Ruby framework that provides a unified interface for multiple AI providers (OpenAI, xAI, Anthropic, Gemini, VertexAI, etc.) to build chats, agents, tools, RAG workflows, and Rails-ready AI features. It emphasizes Rails familiarity and offers components for chats, image/video/audio processing, embeddings, moderation, tools, agents, and structured outputs.
How it works
The project exposes a set of APIs and DSLs to interact with AI providers through a consistent interface:
- Chat: RubyLLM.chat, with support for streaming responses via blocks.
- Vision/Audio/Documents: methods like paint, transcribe, speak, and document extraction.
- Tools and Agents: define Ruby classes to perform tool actions and compose agents with model and tool configurations.
- Structured output: supports Ruby schemas for typed structured responses.
- Rails integration: provides generators for Rails apps and optional UI integration.
- Async: fiber-based concurrency for tool execution.
Getting started
Install and configure:
# Gemfile
gem 'ruby_llm'
Then bundle install:
bundle install
Configure API key:
# config/initializers/ruby_llm.rb
RubyLLM.configure do |config|
config.openai_api_key = ENV['OPENAI_API_KEY']
end
Recent releases
- 1.16.0 (2026-06-09): Concurrent Tool Execution + Rails-style Instrumentation + api_base support for all providers + fixes
- 1.15.0 (2026-05-07): Image Editing + Cost Tracking + Less Glue Code
- 1.14.1 (2026-04-02): Leaner Providers + ActiveStorage fix
- 1.14.0 (2026-03-16): Tailwind Chat UI + Rails AI Generators + Config DSL
- 1.13.2 (2026-03-05): Patch fixes for schema + streaming
Traction
Stars: 4279
Behind the repo
Not provided in the README excerpt.
Caveats
License: MIT Created: 2025-01-30 Last push: 2026-07-26 open issues: 54 Language: Ruby