elizaOS

자율 에이전트를 위한 런타임과 제품 묶음

git clone --filter=blob:none https://github.com/elizaos/eliza.git && cd eliza && bun install

자율 에이전트를 만들고 돌리기 위한 타입스크립트 프레임워크와 제품 묶음입니다. 한 저장소 안에 핵심 런타임과 앱, CLI, 클라우드 서비스, 네이티브 연결, 기본 플러그인이 함께 들어 있습니다. 기기 전체를 이 시스템으로 돌리는 부팅 가능한 배포판은 별도 저장소로 나뉘어 있습니다. 저장소를 받아 돌리면 의존성 설치 과정이 하위 모듈과 패치를 준비하고 호스트 빌드 준비물을 갖추며 데스크톱 추론 라이브러리까지 빌드하거나 확인합니다. 임베딩 모델은 로컬 추론을 준비할 때 자동으로 내려받습니다.

판단

이럴 때 씁니다

  • 자율 에이전트를 만들고 배포까지 한 스택에서 다룰 때
  • 플러그인으로 기능을 확장하는 구조가 필요할 때
  • 데스크톱과 클라우드를 함께 쓰는 구성을 찾을 때

이럴 땐 쓰지 마세요

  • 안정 태그가 없고 베타 판만 붙습니다
  • 소스에서 돌리면 준비 과정이 무겁습니다
  • 부팅 배포판은 별도 저장소라 여기서 찾을 수 없습니다

차별점

  • 런타임과 앱, CLI, 클라우드, 플러그인을 한 저장소에 모았습니다.
  • 부팅 가능한 운영체제 배포판까지 제품군에 포함합니다.
  • 로컬 추론을 위한 네이티브 연결을 함께 빌드합니다.

워크플로

  1. 01저장소를 얕게 받아 의존성을 설치합니다.
  2. 02설치 과정이 하위 모듈과 빌드 준비물을 갖춥니다.
  3. 03개발 모드로 띄웁니다.
  4. 04에이전트나 플러그인을 만듭니다.
  5. 05필요하면 배포된 앱이나 클라우드를 씁니다.

주요 명령

명령설명
git clone --filter=blob:none https://github.com/elizaos/eliza.git저장소를 얕게 받습니다.
bun install의존성과 하위 모듈, 빌드 준비물을 함께 갖춥니다.
bun run dev개발 모드로 띄웁니다.

함정

설치 전에 확인하세요

  • 안정 판 태그가 없습니다. 태그는 전부 베타이고 배포 항목은 검증 자료 형태로 붙어 있어 판 번호로 안정성을 판단할 수 없습니다.
  • 의존성 설치가 하위 모듈과 패치, 호스트 빌드 준비물, 데스크톱 추론 라이브러리까지 건드립니다. 시간이 오래 걸리고 실패 지점이 많습니다.
  • 임베딩 모델이 로컬 추론 준비 중에 자동으로 내려받힙니다. 대역폭과 디스크를 미리 생각해야 합니다.
  • 기기 전체를 이 시스템으로 돌리는 배포판은 다른 저장소에 있습니다. 이 저장소에서 찾으면 없습니다.

비교

에이전트 프레임워크는 보통 라이브러리 하나로 끝납니다. 이쪽은 라이브러리부터 앱, 클라우드, 기기 배포판까지 제품군으로 밀고 나가는 쪽입니다. 범위가 넓은 만큼 판 관리가 느슨하고, 안정 태그가 없다는 점은 도입 전에 감안해야 합니다.

최근 변경

최근 배포 항목이 변경 요청 검증 자료 형태로 올라오고 있습니다. 실제 판 태그는 2.0.11 베타 계열에 머물러 있습니다.