GitHub 오픈소스 탐험

AI 기술이 발전하면서 다양한 AI API들이 등장하고 있지만, 각 API마다 클라이언트와 응답 포맷이 다르다는 문제는 여전히 우리를 괴롭히고 있습니다. 이러한 문제를 해결하기 위해 등장한 것이 바로 RubyLLM입니다. 이 오픈소스 프로젝트는 여러 AI 제공업체의 API를 통합하여 하나의 아름다운 Ruby API로 사용할 수 있게 해줍니다. 이제 RubyLLM으로 AI 챗봇, 에이전트, RAG(리트리벌-어그멘테이션-생성) 애플리케이션을 쉽게 구축해보겠습니다.

RubyLLM의 핵심 기능

RubyLLM은 다음과 같은 주요 기능을 제공합니다:

통합 API: OpenAI, Anthropic, Google Gemini, AWS 등 여러 AI API를 하나의 인터페이스로 제공합니다.
다양한 파일 분석: 이미지, 비디오, 오디오 등 다양한 파일 형식을 분석할 수 있습니다.
스트리밍 응답: AI의 응답을 스트리밍 방식으로 받아볼 수 있어, 실시간 상호작용이 가능합니다.
도구 및 에이전트 사용: 사용자 정의 도구와 에이전트를 생성하여 특정 작업을 수행할 수 있습니다.

설치 방법

RubyLLM을 사용하기 위해서는 Ruby 개발 환경이 필요합니다. 아래와 같은 명령어로 Gem을 설치하세요:

gem install ruby_llm

그 후, Ruby 프로젝트에서 RubyLLM을 불러올 수 있습니다.

require 'ruby_llm'

기본 사용법

이제 RubyLLM을 사용하여 AI와 대화하는 간단한 예제를 살펴보겠습니다.

1. 기본 질문하기

# 질문하기
chat = RubyLLM.chat
response = chat.ask("루비를 배우는 가장 좋은 방법은 무엇인가요?")
puts response.content

2. 다양한 파일 분석하기

RubyLLM은 이미지, 비디오, 오디오 파일을 분석할 수 있습니다. 예를 들어, 이미지 파일을 분석하고 싶다면 다음과 같이 사용할 수 있습니다.

response = chat.ask("이 이미지에 무엇이 있나요?", with: "ruby_conf.jpg")
puts response.content

3. 스트리밍 응답

AI의 응답을 스트리밍 방식으로 받아보는 것도 가능합니다.

chat.ask("루비에 대한 이야기를 들려주세요.") do |chunk|
  print chunk.content
end

4. 이미지 생성하기

AI에게 특정한 이미지를 생성하도록 요청할 수도 있습니다.

RubyLLM.paint("산 위의 일몰을 수채화 스타일로 그려주세요.")

5. 사용자 정의 도구 만들기

다양한 도구를 정의하여 AI가 이를 사용할 수 있습니다.

class Weather < RubyLLM::Tool
  desc "현재 날씨를 가져옵니다."

  def execute(latitude:, longitude:)
    url = "https://api.open-meteo.com/v1/forecast?latitude=#{latitude}&longitude=#{longitude}&current=temperature_2m,wind_speed_10m"
    JSON.parse(Faraday.get(url).body)
  end
end

chat.with_tool(Weather).ask("베를린의 날씨는 어때요?")

6. 에이전트 정의하기

에이전트를 정의하면 특정 작업을 더 쉽게 수행할 수 있습니다.

class WeatherAssistant < RubyLLM::Agent
  model "gpt-5-nano"
  instructions "간결하게 대답하고 항상 도구를 사용하세요."
  tools Weather
end

WeatherAssistant.new.ask("베를린의 날씨는 어떤가요?")

활용 시나리오

RubyLLM은 다양한 실제 시나리오에서 활용될 수 있습니다. 예를 들어, 고객 지원 챗봇을 구축할 때, RubyLLM을 사용하여 고객의 질문에 실시간으로 응답하고, 필요한 경우 API를 통해 관련 정보를 조회할 수 있습니다. 또한, 회의 내용을 자동으로 기록하고 요약하는 AI 도구를 만들 수도 있습니다.

비교 분석

RubyLLM 외에도 여러 AI API 클라이언트들이 존재합니다. 예를 들어, OpenAI의 공식 Ruby 클라이언트도 있지만, RubyLLM은 통합된 API를 제공하여 다양한 공급자의 API를 동일한 방식으로 사용할 수 있는 장점이 있습니다. 이는 개발자에게 일관성을 제공하고, 코드의 유지보수를 더 용이하게 만듭니다.

RubyLLM을 활용한 AI 챗봇 개발하기