GitHub 오픈소스 탐험

최근 AI 기술이 급속도로 발전하면서, 여러 오픈소스 프로젝트가 등장하고 있습니다. 그중에서도 RubyLLM은 다양한 AI API를 통합하여 간편하게 사용할 수 있는 아름다운 Ruby API로 큰 주목을 받고 있습니다. 여러 AI 제공자들이 각기 다른 클라이언트를 제공하는 가운데, RubyLLM은 이러한 문제를 해결하고 있습니다. 여러 API를 하나의 일관된 인터페이스로 사용할 수 있도록 해주기 때문이죠. 이 글에서는 RubyLLM의 주요 기능, 설치 방법, 기본 사용법을 자세히 살펴보겠습니다.

RubyLLM의 주요 기능

RubyLLM은 OpenAI, Anthropic, Google, AWS, 그리고 로컬 모델을 포함한 다양한 AI 제공자와 호환됩니다. 이 API는 다음과 같은 주요 기능을 제공하여 개발자들이 손쉽게 AI 애플리케이션을 구축할 수 있도록 도와줍니다.

채팅 기능: AI와의 대화 기능을 제공합니다.
비전: 이미지 및 비디오 분석을 지원합니다.
오디오: 음성을 텍스트로 변환할 수 있습니다.
파일 분석: 다양한 파일 형식에 대한 분석을 지원합니다.
이미지 생성: 원하는 이미지를 생성할 수 있습니다.
임베딩 생성: 텍스트의 의미를 벡터로 변환합니다.
안전성 검토: 콘텐츠의 안전성을 확인합니다.
도구 및 에이전트 정의: 특정 작업을 수행할 수 있는 도구와 지능형 에이전트를 정의할 수 있습니다.

이제 설치 방법과 기본 사용법을 살펴보겠습니다.

설치 방법

RubyLLM을 사용하기 위해서는 Ruby 환경이 필요합니다. RubyGems를 통해 간편하게 설치할 수 있습니다. 아래와 같이 터미널에서 명령어를 실행하세요.

gem install ruby_llm

설치가 완료되면, RubyLLM을 코드에서 사용할 준비가 되었습니다.

기본 사용법

이제 RubyLLM을 사용하여 AI와의 대화를 시작해 볼까요? 아래는 기본적인 사용법을 보여주는 코드 예제입니다.

# RubyLLM을 사용하여 질문하기
require 'ruby_llm'

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

이 코드 블록은 RubyLLM을 사용하여 "루비를 배우는 가장 좋은 방법은 무엇인가요?"라는 질문을 AI에게 던지고, 그 답변을 출력합니다.

파일 분석하기

RubyLLM은 다양한 파일 형식의 내용을 분석할 수 있습니다. 아래는 이미지와 PDF 파일을 분석하는 예제입니다.

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

# PDF 문서 요약하기
response = chat.ask("이 문서의 내용을 요약해 주세요.", with: "contract.pdf")
puts response.content

스트리밍 응답 받기

AI의 응답을 실시간으로 받는 기능도 지원합니다. 아래는 이를 구현한 예제입니다.

# 응답을 스트리밍으로 받기
chat.ask("루비에 대한 이야기를 해줘") do |chunk|
  print chunk.content
end

도구 및 에이전트 사용하기

RubyLLM은 사용자 정의 도구 및 에이전트를 생성할 수 있는 기능도 제공합니다. 예를 들어, 날씨 정보를 가져오는 도구를 정의하고 이를 활용하는 에이전트를 만들어보겠습니다.

class Weather < RubyLLM::Tool
  description "현재 날씨를 가져오는 도구"
  param :latitude
  param :longitude

  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

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

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

이 코드를 실행하면 WeatherAssistant가 베를린의 날씨 정보를 제공해 줄 것입니다.

실무에서의 활용 시나리오

RubyLLM은 다양한 분야에서 활용될 수 있습니다. 예를 들어, 고객 서비스 챗봇을 구축하여 사용자의 문의에 즉각적으로 응답할 수 있습니다. 또한, 이미지 분석 기능을 활용하여 제품 사진의 품질을 평가하거나, 문서 자동 요약 기능을 사용하여 보고서를 신속하게 작성하는 데에도 유용합니다. 업무 효율성을 높이는 데 큰 도움이 될 수 있는 도구입니다.

유사 도구와의 간단한 비교

RubyLLM 외에도 여러 AI API 클라이언트가 존재합니다. 예를 들어, OpenAI의 공식 클라이언트는 특정 API에 국한되어 있어 다양한 AI를 통합하는 데에는 불편할 수 있습니다. RubyLLM은 하나의 API로 여러 AI를 통합하여 동일한 인터페이스로 사용할 수 있다는 점에서 큰 장점이 있습니다.

RubyLLM로 만드는 AI 챗봇, 사용해보니 이렇더군요