
RLAMA
Dontizi · 코딩 · 생산성
RLAMA는 내 문서 위에 비공개 RAG 시스템을 만드는 무료 오픈 소스 CLI 도구다. Ollama RAG 방식으로 로컬 모델을 쓰기 때문에 데이터가 기기 밖으로 나가지 않는다.

RLAMA 소개
What Is RLAMA
RLAMA는 내 문서를 위한 질의응답 도구로, 내 컴퓨터 안에서만 돌아가도록 만들었다. 로컬 RAG 도구이자 명령줄 도구이며, 언어 모델을 오프라인으로 실행하는 Ollama와 결합해 폴더 속 파일을 검색 가능한 지식베이스로 바꾼다. 개발자는 Apache 2.0 라이선스로 공개했고, 코드는 열려 있으며 무료로 쓸 수 있다.
방식은 단순하다. 폴더를 지정하면 RLAMA가 파일을 읽고, 조각으로 나누고, 각 조각의 벡터를 디스크에 저장한다. 질문을 던지면 걸맞는 구절을 찾아 로컬 모델에 넘기고, 모델은 내 자료를 맥락 삼아 답한다. 이 방식을 검색 증강 생성(RAG)이라 부르며, 모델이 기억만으로 추측하지 않도록 답을 실제 출처에 묶어 두는 장치다.
문제는 설치에 있다. RLAMA는 CLI이며 클릭 한 번으로 쓰는 앱이 아니다. 터미널에서 작업하고, 무엇이든 돌아가기 전에 Ollama를 설치하고 실행해 둬야 한다. 호스팅 버전도 없다. 셀프 호스팅 RAG에서는 오히려 이 점이 핵심이다. 결과는 고른 모델과 문서 품질에 달려 있고, 성능이 낮은 하드웨어나 작은 모델은 답에 그대로 드러난다. 프로젝트도 현재 멈춰 있어 새 기능은 한동안 나오지 않는다.
Getting Started
- ollama.ai에서 Ollama를 설치하고 최소 한 개 모델을 받는다. 예를 들어 ollama pull llama3를 실행한다.
- 한 줄 스크립트로 RLAMA를 설치한다. curl -fsSL https://raw.githubusercontent.com/dontizi/rlama/main/install.sh | sh.
- 폴더를 지정해 RAG 시스템을 만든다. rlama rag llama3 my-docs ./docs.
- 대화형 세션을 열고 질문한다. rlama run my-docs.
- 나중에 파일을 추가하려면 rlama add-docs, 자동으로 넣고 싶으면 폴더 감시를 켠다.
제품 정보
RLAMA의 요금, 지원 플랫폼, 성능을 한눈에 확인해 보세요.
추천 대상
이 도구가 가장 잘 맞는 사용자, 작업, 상황입니다.
사용자
- 로컬에서 문서를 검색하려는 개발자
- 개인정보를 중시하는 팀
- 이미 Ollama를 쓰는 사람
- RAG 구조를 알고 싶은 사람
작업
- 문서 폴더 전체에 질문하기
- 코드베이스 검색
- 웹사이트로 지식베이스 만들기
- 지식베이스 최신화
- 다른 도구에 RAG 연결
활용 상황
- 고객 계약서를 어디에도 올릴 수 없는 프리랜서
- 큰 저장소를 뒤지는 개발자
- PDF를 잔뜩 쌓아 둔 연구자
- 작은 모델을 시험하는 취미 사용자
주요 기능
로컬 RAG 파이프라인
rag 명령으로 폴더를 색인하고, run 명령으로 질의하고, ~/.rlama 안 로컬 파일로 전부 유지한다. 문서는 읽히고, 조각나고, Ollama를 거쳐 벡터가 되고, 디스크에 저장된다. 외부 서버는 전혀 건드리지 않는다. 이게 이 도구의 요점이다.
여러 분할 전략
RLAMA는 문서를 네 가지로 나눈다. 고정 크기, 의미 기반, 계층형, 하이브리드다. 하이브리드는 파일 종류별로 가장 나은 방법을 골라, Markdown은 제목으로, 코드는 함수와 클래스로, 일반 텍스트는 문단으로 자른다. 조각이 좋아야 검색이 좋아지며, 많은 로컬 RAG 도구가 여기서 발목을 잡힌다.
웹사이트 크롤링과 감시
crawl-rag 명령은 폴더 대신 사이트에서 RAG를 만든다. 깊이, 동시성, 제외 경로를 조절할 수 있다. web-watch는 그 사이트를 지켜보며 새 페이지를 색인에 넣는다. 문서 사이트를 수작업으로 다시 색인하지 않아도 최신으로 유지된다.
폴더 감시
RAG에 폴더를 붙여 일정 간격으로 확인하게 하거나, 그 RAG를 쓸 때만 확인하게 할 수 있다. 새 파일은 알아서 색인에 들어간다. 변경 때마다 add-docs를 돌려야 하는 번거로움이 사라진다.
내장 API 서버
api 명령이 HTTP 서버를 띄우고, 단일 POST /rag 엔드포인트가 RAG 이름, 프롬프트, 선택적 맥락 크기를 받는다. 로컬 문서 질의응답을 스크립트나 작은 앱, CLI를 모르는 도구에 끼워 넣을 수 있다.
Ollama와 Hugging Face 모델
RLAMA는 벡터화와 생성을 모두 Ollama에 기대며, Ollama가 돌릴 수 있는 모델이면 무엇이든 받는다. hf-browse와 run-hf 명령은 Hugging Face의 GGUF 목록까지 닿아, RAG에 넣기 전에 모델을 찾고 시험할 수 있다.
장단점
장점
- 완전히 오프라인으로 돌아 문서가 기기 밖으로 나가지 않고, 질의마다 드는 비용도 없다.
- Apache 2.0으로 무료 오픈 소스이며, 단일 Go 바이너리를 한 줄로 설치한다.
- 네 가지 분할 전략과 웹 크롤러를 갖춰 대부분의 로컬 RAG 입문 도구보다 깊다.
- 내장 API 서버 덕분에 CLI가 다른 도구가 호출할 수 있는 대상이 된다.
- Linux, macOS, Windows에서 돌아가며 클라우드에 의존하지 않는다.
단점
- CLI 전용이라 데스크톱 앱을 기대하는 사람은 터미널에서 작업해야 한다.
- 설치에 Ollama 실행과 모델 다운로드가 먼저 필요하고, 이 단계가 초보자를 막는다.
- 답의 품질은 고른 모델을 따라가므로, 작은 모델과 낮은 성능의 하드웨어는 결과를 얕게 만든다.
- 개발이 멈춰 있어 당장 새 기능이 없고 수정도 느려진다.
자주 묻는 질문
RLAMA는 내 파일 위에 비공개 질의응답 시스템을 만든다. 폴더나 사이트를 색인한 뒤 질문하면 그 내용에서 답이 나온다. 전부 로컬 Ollama 모델로 돌아간다.
관련 콘텐츠
RLAMA와 관련된 도구, 스킬, 아티클을 살펴보세요.
RLAMA 대안

Udon
Udon · 코딩 · 생산성Udon은 Apple Silicon Mac을 Mac 홈서버로 바꾸는 소프트웨어다. 브라우저에서 컨테이너와 파일 공유를 관리하고, 원하면 AI 시스템 관리자까지 붙일 수 있다.

offstage
offstage cloud · 코딩 · 생산성offstage는 AI 에이전트와 CI 작업에 진짜 Mac을 넘긴다. Apple Silicon 위의 새 macOS 27 계정을 API로 다루고 초 단위로 과금한다.
BotBus
Chengdu Tuyang Tusen Technology Co., Ltd. · 코딩 · 생산성BotBus는 AI 코딩 에이전트 원격 제어 앱이다. 스마트폰과 워치에서 명령을 승인하고, 작업을 시작하고, 결과를 확인한다.
