Ryu: 처음부터 시작하지 않고 AI 에이전트를 구축하고 실행하세요

<a href="https://ryuhq.com"> <picture> <source media="(prefers-color-scheme: dark)" srcset=".github/banner-dark.png" /> <img src="https://raw.githubusercontent.com/amajorai/ryu/HEAD/.github/banner.png" alt="Ryu — Build and run AI agents without starting from scratch" width="100%" /> </picture> </a> <img src="https://raw.githubusercontent.com/amajorai/ryu/HEAD/.github/logo.png" width="96" alt="" /> <h1 align="center">Ryu</h1> 처음부터 시작하지 않고 AI 에이전트를 구축하고 실행하세요. 플러그인을 통해 기능을 확장하거나, 에이전트를 앱으로 전환할 수 있습니다. <a href="https://github.com/amajorai/ryu/stargazers"><img src="https://shieldcn.dev/github/stars/amajorai/ryu.svg" alt="GitHub stars" /></a>  <a href="https://github.com/amajorai/ryu/releases"><img src="https://shieldcn.dev/github/release/amajorai/ryu.svg" alt="Latest release" /></a>  <a href="https://github.com/amajorai/ryu/actions/workflows/ci.yml"><img src="https://shieldcn.dev/github/ci/amajorai/ryu.svg?workflow=ci.yml&branch=main" alt="CI" /></a> <a href="https://docs.ryuhq.com"><img src="https://shieldcn.dev/badge/Docs-docs.ryuhq.com-73DC8C.svg?logo=readthedocs&logoColor=white" alt="Docs" /></a>  <a href="https://ryuhq.com/download"><img src="https://shieldcn.dev/badge/Ryu-Desktop-4B78E6.svg?logo=tauri&logoColor=white" alt="Ryu Desktop" /></a>  <a href="https://ryuhq.com/discord"><img src="https://shieldcn.dev/discord/1439211418724597800.svg?logo=discord&logoColor=white&color=4B78E6" alt="Discord" /></a>  <a href="https://x.com/ryuhq"><img src="https://shieldcn.dev/badge/[email protected]?logo=x&logoColor=white" alt="Follow @ryuhq" /></a>  <a href="./LICENSING.md"><img src="https://shieldcn.dev/badge/License-Open--core-73DC8C.svg?logo=opensourceinitiative&logoColor=white" alt="Open core" /></a>

구성 요소 연결 방법

동일한 계약(contracts)이 런타임, 통합 접합부(integration seams), 표면(surfaces), 그리고 배포 선택지들을 연결합니다.

SDK, Core, Gateway, 앱(apps), 플러그인(plugins), 및 API를 사용하여 구축하세요. Ryu는 데스크톱, 웹 브라우저, 모바일, CLI, 봇(bots), 채널 등을 통해 로컬 또는 자체 서버, 또는 Ryu Cloud에서 실행할 수 있습니다.

이 저장소에는 Core, Gateway, CLI, Desktop, Island, 공유 런타임 패키지, 그리고 셀프 호스팅 파일들이 포함되어 있습니다. SDK와 예제는 public SDK hub에 있으며; 앱 소스는 그 ryu-<app> 위성 저장소에 있고; 플러그인 소스 및 카탈로그는 Marketplace repository에 있습니다. 전체 제품 문서는 docs.ryuhq.com에서 확인할 수 있습니다.

Ryu 비교 방법

이 표들은 모델 품질, 지연 시간(latency), 또는 보안 인증을 비교하는 것이 아니라 문서화된 제품의 표면들을 비교합니다.

범례: ✅ 1급으로 문서화된 기능 · 🟡 구성(composition), 설정(configuration) 또는 제한적/프리뷰 표면을 통해 사용 가능 · ❌ 제품의 주요 문서화된 표면이 아님.

에이전트 프레임워크 및 로컬 런타임

| 기능 | Ryu | DeepSeek Harness | Mastra | LangChain / LangGraph | eve | OpenClaw | Hermes Agent | Omnigent |
| --- | --- | --- | --- | --- | --- | --- | --- |
| 기존 에이전트 또는 하네스 사용 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | 🟡 | ✅ |
| ...

관리형 에이전트 제품 및 클라우드 플랫폼

Capability	Ryu	Claude Managed Agents	Notion Custom Agents	Grok Bot	Hyperagent	Vercel AI Cloud	ChatGPT Workspace Agents	Microsoft Foundry	Vertex AI Agent Engine
Use an existing agent or harness	✅	🟡	❌	❌	🟡	🟡	❌	✅	✅
...

빠른 시작 (Quick Start)

Core와 Gateway를 사용자가 통제하는 인프라에 배포하세요. Ryu 계정이나 제어 평면(control-plane) 서비스는 필요하지 않습니다.

macOS 및 Linux:

curl -fsSL https://raw.githubusercontent.com/amajorai/ryu/main/install.sh | sh
ryu-cli

Windows PowerShell:

irm https://raw.githubusercontent.com/amajorai/ryu/main/install.ps1 | iex
ryu-cli

설치 프로그램은 번들된 로컬 기본값과 함께 Core와 Gateway를 시작합니다. 제공업체(providers), 배포 및 구성에 대한 자세한 내용은 셀프 호스팅 가이드 (self-hosting guide)를 참조하세요.

라이선싱 (Licensing)

Core와 SDK는 Apache-2.0입니다. Gateway는 AGPL-3.0입니다. Desktop, Island 및 공유 UI 패키지는 LICENSE-COMMERCIAL.md에 따라 소스 사용 가능(source-available)합니다. 전체 경계에 대해서는 LICENSING.md와 TRADEMARK.md를 참조하세요.

Ryu는 1.0 이전 버전입니다. 인터페이스, API 및 온디스크 형식은 릴리스 간에 변경될 수 있습니다.

기여 (Contributing)

이 저장소에 풀 리퀘스트(pull request)를 열어 코드나 문서를 기여하세요. 기여 가이드부터 시작하세요. SDK는 SDK 허브를, 앱은 관련 ryu-<앱> 위성 저장소(satellite)를, 플러그인은 마켓플레이스 저장소를 사용하세요. 보안 문제는 SECURITY.md를 통해 신고해 주세요.

스타 히스토리 (Star History)