Repolode
OlympiaAI

OlympiaAI/raix

Ruby 앱에 채팅 완성, 도구 호출, 프롬프트 체인, 구조화된 출력을 추가할 수 있는 Ruby 라이브러리입니다.

스타
329
포크
30
열린 이슈
11
마지막 커밋
2개월 전

어떤 프로젝트인가요?

Raix는 일반 Ruby 클래스에 대규모 언어 모델 기능을 추가하는 Ruby gem입니다. ChatCompletion 같은 모듈을 포함하면 대화 기록과 chat_completion 메서드를 사용할 수 있으며, OpenRouter를 통해 OpenAI, Anthropic, Google Gemini 등의 모델을 호출합니다. 공급자 연결에는 RubyLLM을 사용하고, ActiveSupport를 사용할 수 있다면 Rails 앱이 아닌 환경에서도 작동합니다.

기본적인 완성 기능 외에도 Raix는 선언형 함수 DSL을 사용한 자동 도구(함수) 호출을 지원합니다. 도구의 결과를 모델에 다시 전달하다가 텍스트 응답을 반환하면 멈춥니다. 또한 순서가 지정된 프롬프트 체인을 실행하는 PromptDeclarations 모듈, 예/아니요/잘 모르겠음 형식의 질문을 처리하는 Predicate 모듈, 원격 도구 서버용 실험적 MCP 클라이언트 지원, JSON Schema 출력을 위한 ResponseFormat 클래스도 제공합니다. 훅을 사용하면 요청을 보내기 전에 수정할 수 있습니다. 예를 들어 테넌트별로 모델을 선택하거나 개인 데이터를 마스킹할 수 있습니다.

이 코드는 가상 AI 팀 플랫폼인 Olympia에서 분리해 추출한 것이며, 작성자는 AI를 활용한 애플리케이션 패턴을 다룬 관련 서적에서 설계 접근 방식도 설명합니다.

핵심 기능

  • 01줄임 형식이나 OpenAI 스타일의 메시지 해시를 받는 대화 기록을 지원하는 채팅 완성 기능.
  • 02선언형 DSL과 설정 가능한 호출 횟수 제한을 갖춘 자동 도구 함수 호출.
  • 03조건, 콜백, 반복 실행을 지원하는 PromptDeclarations 기반 프롬프트 체인.
  • 04구조화된 출력을 위한 JSON 모드 및 JSON Schema 응답 형식.
  • 05Anthropic 스타일 프롬프트 캐싱과 요청을 수정하는 before_completion 훅.

활용 사례

  • Rails 모델이나 서비스 객체에 AI 요약 또는 분류 단계를 추가할 때.
  • 각 LLM 호출 결과를 다음 프롬프트에 전달하는 다단계 파이프라인을 구축할 때.
  • LLM이 애플리케이션의 Ruby 메서드를 호출해 데이터를 가져오거나 워크플로를 실행하도록 할 때.
  • 실험 목적으로 Ruby 앱을 원격 MCP 도구 서버에 연결할 때.

빠른 시작

  1. 1

    Gemfile에 gem을 추가하세요

    bundle add raix
  2. 2

    Ruby 클래스에 Raix::ChatCompletion을 포함하고 chat_completion을 호출하세요

사용 전 알아둘 점

  • Raix 3.0은 RubyLLM과 OpenRouter를 사용하므로 OpenAI 또는 Anthropic과 같은 제공업체의 API 키가 필요합니다.
  • Rails가 아닌 애플리케이션은 종속성에 ActiveSupport를 포함해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

raix은(는) 무엇인가요?
Ruby 앱에 채팅 완성, 도구 호출, 프롬프트 체인, 구조화된 출력을 추가할 수 있는 Ruby 라이브러리입니다. Raix는 일반 Ruby 클래스에 대규모 언어 모델 기능을 추가하는 Ruby gem입니다. ChatCompletion 같은 모듈을 포함하면 대화 기록과 chat_completion 메서드를 사용할 수 있으며, OpenRouter를 통해 OpenAI, Anthropic, Google Gemini 등의 모델을 호출합니다. 공급자 연결에는 RubyLLM을 사용하고, ActiveSupport를 사용할 수 있다면 Rails 앱이 아닌 환경에서도 작동합니다.
raix은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
raix은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
raix은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. raix의 마지막 커밋은 2026년 9월 22일입니다.
raix은(는) 어디에 사용할 수 있나요?
Rails 모델이나 서비스 객체에 AI 요약 또는 분류 단계를 추가할 때. 각 LLM 호출 결과를 다음 프롬프트에 전달하는 다단계 파이프라인을 구축할 때. LLM이 애플리케이션의 Ruby 메서드를 호출해 데이터를 가져오거나 워크플로를 실행하도록 할 때. 실험 목적으로 Ruby 앱을 원격 MCP 도구 서버에 연결할 때.
raix는 어떻게 설치하나요?
Gemfile에 gem을 추가하세요: bundle add raix Ruby 클래스에 Raix::ChatCompletion을 포함하고 chat_completion을 호출하세요
raix은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/OlympiaAI/raix

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트