1. 프로젝트 개요
eliza는 자율 AI 에이전트를 구축하기 위한 오픈소스 TypeScript 프레임워크입니다. AI 에이전트는 Discord, Telegram, 블록체인과 같은 플랫폼에서 채팅하고, 맥락을 기억하고, 도구를 사용하고, 작업을 수행할 수 있는 소프트웨어 개체로, 개발자가 통합 코드를 처음부터 작성할 필요가 없습니다.
2. 배경 및 포지셔닝
elizaOS는 웹, 데스크톱, 모바일, 메시징 플랫폼 등 다양한 표면에서 일관되게 작동하는 AI 에이전트를 구축하기 위한 접근 가능하고 확장 가능한 기반을 개발자에게 제공하기 위해 만들어졌습니다. 사용자 자율성을 보존하고, 원하는 경우 로컬 온디바이스 추론을 통해 프라이버시를 보호합니다. 핵심 사명은 에이전트 개발을 모든 플랫폼과 모델 제공업체에 대한 맞춤형 통합을 구축하는 것이 아니라 플러그인을 작성하는 것만큼 접근하기 쉽게 만드는 것입니다.
단일 목적의 챗봇 SDK나 폐쇄형 에이전트 플랫폼과 달리 elizaOS는 다음과 같습니다:
- 런타임 중심, 앱 중심 아님 — 공유
@elizaos/core런타임이 메모리, 메시지 루프, 에이전트 상태를 처리하므로 동일한 에이전트 정의가 Discord 봇, 웹 앱 또는 CLI 프로세스로 실행될 수 있습니다. - 모델에 구애받지 않음 — 에이전트는 클라우드 모델 제공업체를 호출하거나 Eliza-1 모델 레지스트리를 통해 로컬 모델(2B~27B 파라미터)을 실행할 수 있어 팀이 편의성과 완전한 로컬 제어 사이에서 선택할 수 있습니다.
- 깊은 플러그인 가능성 — 거의 모든 에이전트 기능(플랫폼 커넥터, 블록체인 지갑, 도구)은 프레임워크에 하드코딩되는 대신 대규모 커뮤니티 유지 관리 플러그인 생태계를 통해 제공됩니다.
3. 기능 카테고리
- 🔌 플랫폼 커넥터 — 90개 이상의 플러그인, 예: Discord, Telegram, Slack, Twitter/X, Farcaster. 목적: 단일 에이전트 정의가 채팅 및 소셜 플랫폼에서 기본적으로 작동하도록 합니다.
- ⛓️ 블록체인 및 지갑 — 예: Ethereum 플러그인, Solana 플러그인, 비수탁형 지갑 작업, 트랜잭션 승인 흐름. 목적: 에이전트가 명시적이고 제한된 사용자 승인 하에 암호화폐 지갑을 보유하고 사용할 수 있도록 합니다.
- 🧠 모델 및 추론 — 예: Eliza-1 로컬 모델 레지스트리, 클라우드 모델 제공업체 어댑터, Eliza Cloud 모델 라우팅. 목적: 개발자에게 로컬 비공개 추론과 호스팅된 클라우드 라우팅 추론 사이의 선택권을 제공합니다.
- 🧩 에이전트 런타임 기본 요소 — 예: Actions, Providers, Evaluators, Services, Characters. 목적: 모든 플러그인이 등록하는 구성 가능한 빌딩 블록으로, 에이전트의 행동과 성격을 형성합니다.
- 🗓️ 생산성 및 유틸리티 통합 — 예: 캘린더 접근, 알림, 문서/지식 처리, 자동화 도구. 목적: 에이전트를 대화를 넘어 실용적인 일상 작업 지원으로 확장합니다.
4. 주요 하이라이트
- 캐릭터 기반 성격 — 에이전트의 행동과 어조는 "캐릭터" 파일을 통해 선언적으로 정의되어 성격 구성을 런타임 코드와 분리합니다.
- Actions, Providers, Evaluators 모델 — 에이전트가 할 수 있는 것(actions), 끌어올 수 있는 맥락(providers), 자신의 응답을 평가하는 방법(evaluators) 사이의 명확한 분리를 통해 플러그인 동작을 예측 가능하고 구성 가능하게 만듭니다.
- 로컬 우선 추론 옵션 — Eliza-1 모델 레지스트리를 통해 에이전트가 완전히 온디바이스에서 실행될 수 있으며, 이는 프라이버시 또는 오프라인 요구 사항이 있는 팀에게 중요하며 선택적 클라우드 경로도 제공합니다.
- 비수탁형 블록체인 지원 — EVM 및 Solana 체인의 지갑 작업은 무제한 트랜잭션 서명이 아닌 명시적 승인 경계로 범위가 제한됩니다.
- 멀티 플랫폼 애플리케이션 제품군 — 프레임워크 자체 외에도 elizaOS는 웹, 데스크톱, 모바일 및 부팅 가능한 OS 배포판을 제공하므로 동일한 에이전트를 개발자뿐만 아니라 최종 사용자에게도 배포할 수 있습니다.
- 대규모 자사 플러그인 생태계 — 90개 이상의 플러그인이 메시징 플랫폼, 블록체인 및 기기 브리지를 다루어 대부분의 프로젝트가 작성해야 하는 맞춤형 통합 코드의 양을 줄입니다.
5. 역할별 사용 사례
- 일반 개발자 — 플랫폼 SDK를 직접 작성하는 대신 기존 플러그인(Discord, Telegram, 캘린더)을 구성하여 맞춤형 채팅 또는 자동화 에이전트를 구축합니다.
- 데이터/연구 과학자 — 지식 및 문서 처리 워크플로우와 로컬 모델 추론을 결합하여 데이터를 제3자 API로 보내지 않고 검색 및 메모리 증강 에이전트를 실험합니다.
- 프로젝트 관리자 — 최소한의 맞춤형 코드로 캘린더 관리, 알림 및 크로스 플랫폼 조정(예: Discord/Slack 어시스턴트)을 위한 에이전트를 배포합니다.
6. 시작하기
필요한 것 찾기 — 플러그인 레지스트리 및 문서 탐색:
https://docs.elizaos.ai/
설치/통합 — 저장소를 클론하고 개발 환경을 시작합니다:
git clone --filter=blob:none https://github.com/elizaos/eliza.git
cd eliza
bun install
bun run dev
기여 — 중요한 변경 사항을 논의하기 위해 이슈를 열고 develop 브랜치에 풀 리퀘스트를 제출합니다:
git clone https://github.com/elizaos/eliza.git
전체 요구 사항은 저장소의 CONTRIBUTING.md를 참조하세요.
7. 프로젝트 구조
eliza/
├── packages/
│ ├── core/ # @elizaos/core — 런타임, 타입, 메시지 루프, 메모리 기본 요소
│ ├── agent/ # @elizaos/agent — 독립 실행형 에이전트 프로세스 및 HTTP 백엔드
│ ├── app-core/ # @elizaos/app-core — 애플리케이션 호스팅 및 오케스트레이션
│ ├── ui/ # @elizaos/ui — 공유 React 컴포넌트
│ └── cli/ # 스캐폴딩 및 에이전트 실행을 위한 명령줄 도구
├── plugins/ # 자사 플러그인(플랫폼 커넥터, 블록체인, 모델)
├── scripts/ # 저장소 유지 관리 유틸리티
└── patches/ # 의존성 패치
packages/core 런타임은 다른 모든 패키지와 플러그인이 기반으로 하는 공유 기반입니다. plugins/는 개발자가 새로운 에이전트 기능을 추가하거나 발견하는 주요 장소입니다.
8. 관련 생태계
- Eliza Cloud — 오픈소스 프레임워크로 구축된 에이전트를 위한 인증, 모델 라우팅 및 배포를 제공하는 선택적 호스팅 플랫폼입니다.
- Eliza-1 모델 레지스트리 — 온디바이스 추론을 위해 런타임의 모델 핸들러 인터페이스에 연결되는 로컬 모델(2B~27B 파라미터) 세트입니다.
- 모델 제공업체 및 메시징 플랫폼 — 플러그인 시스템은 Discord, Telegram, Slack 및 블록체인 네트워크(Ethereum, Solana)와 같은 제3자 서비스에 연결되며, 이러한 서비스는 elizaOS 프로젝트 외부에서 독립적으로 운영되는 서비스로 유지됩니다.
9. 라이선스
- ✅ MIT 라이선스에 따라 상업적 목적을 포함하여 eliza를 사용, 수정 및 배포할 수 있습니다.
- ✅ 프로젝트를 포크하여 독점 에이전트 또는 제품을 그 위에 구축할 수 있습니다.
- ❌ 소프트웨어의 사본 또는 상당 부분에서 원본 저작권 및 라이선스 고지를 제거하지 마십시오.
- ℹ️ MIT는 보증을 제공하지 않습니다. 프로덕션에서 eliza를 사용하기 전에 라이선스 텍스트를 검토하고 제3자 유료 서비스에 연결하는 경우 개별 플러그인 라이선스를 확인하세요.
10. FAQ
Q: 에이전트를 실행하려면 Eliza Cloud를 사용해야 하나요?
A: 아니요. Eliza Cloud는 선택 사항입니다. 에이전트는 완전히 로컬에서 또는 직접 구성한 모델 제공업체에서 실행할 수 있습니다.
Q: 에이전트가 클라우드 모델 제공업체에 데이터를 보내지 않고 실행될 수 있나요?
A: 예, 2B~27B 파라미터 범위의 모델에 대한 온디바이스 추론을 지원하는 Eliza-1 로컬 모델 레지스트리를 통해 가능합니다.
Q: 새 채팅 플랫폼에 대한 지원을 어떻게 추가하나요?
A: 관련 actions, providers 및 services를 등록하는 Plugin 객체를 내보내는 플러그인을 빌드하거나 설치하세요. docs.elizaos.ai의 플러그인 문서를 참조하세요.
Q: eliza가 기본적으로 지원하는 블록체인은 무엇인가요?
A: 자사 플러그인은 현재 EVM 호환 체인과 Solana를 다루며, 비수탁형 지갑 작업은 명시적 승인 경계를 따릅니다.
Q: 버그를 보고하거나 기능을 제안하려면 어디로 해야 하나요?
A: CONTRIBUTING.md에 따라 중요한 풀 리퀘스트를 제출하기 전에 GitHub 저장소에 이슈를 여세요.
11. 빠른 링크
- 저장소: https://github.com/elizaOS/eliza
- 문서: https://docs.elizaos.ai/
- 기여 가이드: https://github.com/elizaOS/eliza/blob/develop/CONTRIBUTING.md
- 이슈: https://github.com/elizaOS/eliza/issues
12. 요약
eliza는 개발자에게 채팅 플랫폼, 블록체인 및 로컬 또는 클라우드 추론 백엔드에서 일관되게 작동하는 AI 에이전트를 구축하기 위한 모델에 구애받지 않고 플러그인 기반의 런타임을 제공합니다. 모든 메시징 서비스나 모델 제공업체에 대한 통합을 직접 작성하지 않고 멀티 플랫폼 에이전트를 빠르게 출시하려는 팀과 완전히 로컬이고 비공개인 추론 옵션을 원하는 개발자에게 가장 가치가 있습니다.