Rails AgentsAgents for your Rails app

Define an agent as a plain Ruby class. Attach your app code as tools. Call .run. Speed to production — not framework noise.

Get started

Why Rails Agents

GitHub

One class

Every agent is a subclass of RailsAgents::Agent. Three declarations — provider, model, description — and you're running.

Your tools

Drop Ruby classes in app/agents/tools/. The model calls your models, jobs, and services — not a foreign plugin API.

Built-in skills

Web search, fetch, spreadsheets, PDFs, and more. Native on Anthropic; portable fallbacks elsewhere.

Unified providers

OpenAI, Anthropic, OpenRouter, and Grok behind one DSL. The gem translates the API differences.

ruby

class LeadQualifier < RailsAgents::Agent
  provider :openrouter
  model "meta-llama/llama-3.3-70b-instruct:free"
  description "Qualifies inbound leads and creates a CRM note when promising."
  tools "SearchCrm", "CreateCrmNote"
end

LeadQualifier.run("New signup from acme.com — 50 employees, enterprise pricing")