오픈소스AGPL-3.0한 줄까지 전부 읽을 수 있습니다.
AGPL-3.0-or-later로 공개된 iOS, Android, 웹 클라이언트 전체입니다. 계정도, 구독도, 저희 쪽으로 되돌아오는 것도 없습니다. 읽고, 고치고, 직접 호스팅하세요.
$ git clone https://github.com/oriveo/oriveo.git $ cd oriveo
# Web · Node 22.22+ $ cd web && npm install $ npm run dev:app # localhost:3001
# iOS · Xcode 26, iOS 18+ $ open ios/Oriveo/Oriveo.xcodeproj
# Android · JDK 21 + Android SDK $ cd android && ./gradlew :app:assembleDebug
저장소에는 미리 빌드된 산출물이 없습니다 — APK도, .ipa도 없습니다. 커뮤니티 에디션은 직접 빌드하는 소스입니다.
저장소에는 무엇이 있나
iOS · SwiftUI
SwiftUI 인터페이스에 UIKit transcript, 저장은 GRDB. Xcode 26으로 프로젝트를 열고 Signing에서 자신의 Team을 고르면 자기 폰에서 바로 돌아갑니다.
Android · Compose
Jetpack Compose, Room, Koin, Ktor, OkHttp. JDK 21과 Android SDK만 있으면 assembleDebug 한 번으로 빌드가 나옵니다.
Web · Next.js
Next.js App Router, React, Zustand, TypeScript. 프로젝트에서 서버가 있는 유일한 부분이며, 키도 메시지도 저장하지 않습니다.
macOS · 개발 중
네이티브 macOS 클라이언트는 개발 중이며 이 디렉터리에 들어옵니다. 그 바탕이 되는 Swift wire 계층은 이미 작성되어 테스트 중입니다.
세 클라이언트가 「제공자를 어떻게 호출하는가」를 각자 구현하면 결국 어긋납니다. shared/는 그 동작을 데이터로 적어 둡니다 — capabilityrecipe는 요청을 어떻게 만드는지, model-contracts는 클라이언트가 무엇을 할 수 있는지 정의하고, test-fixtures는 실제 응답을 녹화한 것이며, OriveoProviderKit은 Swift 6.1로 쓴 wire 커널입니다. 세 클라이언트 모두 같은 JSON을 기준으로 검증합니다.
같은 코드베이스, 두 가지 운영 방식
세 클라이언트의 소스는 같습니다. 차이는 계정, 클라우드 동기화, 그리고 저희가 비용을 부담하는 모델뿐입니다.
| 기능 | 커뮤니티 에디션 | 공식 Oriveo |
|---|---|---|
| 소스 코드 | AGPL-3.0-or-later | 상용 빌드 |
| 내 제공자 키로 대화하기 | 지원 | 지원 |
| Relay 및 로컬 모델 서버 | 지원 | 지원 |
| 노트, 폴더, Skills, 첨부파일 | 지원 | 지원 |
| 기기 내 지출 추적 | 지원 | 지원 |
| 계정 | Oriveo 계정 | |
| 저장 | 기기에 저장, 수동 내보내기와 복원 | 로컬 우선에 더해 기기 간 클라우드 동기화 |
| Usage Insights와 예산 알림 | 지원 | |
| Oriveo가 비용을 부담하는 모델 (Oriveo AI / Oriveo Free) | 지원 | |
| 분석과 크래시 리포트 | 지원 |
커뮤니티 빌드는 ai.oriveo.community 식별자 접두사를 쓰므로, 같은 기기에서 스토어 빌드와 나란히 설치해도 키체인이나 로컬 데이터를 공유하지 않습니다.
지금 있는 자리에서 시작하세요
Issue를 하나 골라 보세요
버그 수정보다 큰 작업이라면 먼저 issue를 열어 주세요. 방식에 대한 이견은 diff에서보다 issue에서 조율하는 편이 훨씬 저렴합니다.
취약점은 비공개로 알려 주세요
보안 문제는 공개 issue로 열지 마세요. GitHub의 비공개 취약점 신고를 쓰거나, 제목에 SECURITY를 넣어 [email protected]으로 메일을 보내 주세요. 며칠 안에 답을 드립니다.
언어를 하나 더해 주세요
앱 인터페이스는 16개 언어로 제공되고 README도 마찬가지입니다. 번역이 어색하거나 새 언어를 넣고 싶다면 PR을 환영합니다.
저장소는 통째로 clone 해 주세요 — 세 클라이언트 모두 저장소 루트에서 shared/의 계약 fixture를 찾기 때문에, 얕은 체크아웃으로는 테스트가 통과하지 않습니다.
서비스로 제공한다면, 당신의 변경분도 공개해야 합니다.
사용자의 API Key를 다룰 수 있는 클라이언트에게는 이것이 정확히 알맞은 제약입니다: 누군가 어떤 버전을 호스팅하든, 그 버전이 실제로 무엇을 하는지 읽을 수 있으니까요. 직접 빌드해서 혼자 쓰는 데에는 아무 영향이 없습니다. 기여 역시 같은 AGPL-3.0-or-later 조건으로 받습니다.