Dspy.Rb

DSPy.rb

[](https://rubygems.org/gems/dspy) [](https://rubygems.org/gems/dspy) [](https://github.com/vicentereig/dspy.rb/actions/workflows/ruby.yml) [](https://oss.vicente.services/dspy.rb/) [](https://discord.gg/zWBhrMqn)

**Build typed agents and model-backed programs in Ruby.**

DSPy.rb brings [DSPy](https://dspy.ai)'s signature, module, agent, and optimizer model to Ruby, with Sorbet types and Ruby-native integrations. A signature declares a task as typed inputs and outputs. A module chooses how to execute it. Ruby composes modules into programs, while `ReAct` adds a bounded loop when the model should choose the next action. DSPy.rb builds the provider request and validates the returned shape.

The `1.x` series is the current stable release line.

In a configured application, the task contract and call look like this:

class Classify < DSPy::Signature
  class Sentiment < T::Enum
    enums do
      Positive = new('positive')
      Negative = new('negative')
      Neutral = new('neutral')
    end
  end

  input do
    const :sentence, String
  end

  output do
    const :sentiment, Sentiment
    const :confidence, Float
  end
end

classifier = DSPy::Predict.new(Classify)
result = classifier.call(sentence: "This book was fun to read!")

Define a typed task contract instead of maintaining an output template. Receive validated Ruby values instead of parsing provider JSON. Handle configuration, transport, and validation errors explicitly.

Start Here

The [Quick Start](https://oss.vicente.services/dspy.rb/getting-started/quick-start/) is the