<div align="center">
<img src="https://raw.githubusercontent.com/JiangNanGenius/floe-agent/HEAD/docs/images/floe-agent-icon.png" width="88" alt="Floe Agent app icon">
<h1>Floe Agent</h1>
<p><strong>당신의 모델. 당신의 파일. 당신의 기기.</strong></p>
<p>Floe Agent는 iOS 및 Android용으로 설계된 오픈 소스 온디바이스 AI 에이전트 작업 공간입니다 — iPad 우선이며, 네이티브 iPhone 지원 기능을 갖추고 있습니다. AI 작업, 메모(Notes), 오피스 문서, 크리에이티브 도구, 개발 환경을 하나로 통합합니다. 이 시스템은 기기에서 코드를 실행하고 패키지 및 서비스를 구동하는 실제 Linux 환경을 제공하며, 온디바이스 추론을 위한 로컬 지원 모델과 사용자의 API 키를 활용한 클라우드 AI(BYOK) 기능을 지원합니다.</p>
<p><a href="README.zh-CN.md">简体中文</a> · <a href="https://www.floe-agent.com/">웹사이트</a> · <a href="docs/USER_GUIDE.md">사용자 매뉴얼</a> · <a href="docs/README.md">문서</a></p>
</div>
Release
iOS 26+
Android 9+ ARM64 alpha
MPL 2.0
설치 시작 · 기능 · 데모 · 문서 · 개발 · 참여 및 라이선스
설치 시작
웹사이트에서 설치 채널을 선택하세요. 각 채널의 버전, 지역 및 적격 여부는 현재 상태와 설치 페이지를 확인하세요.
<p align="center">
<a href="https://altdirect.app/?url=https%3A%2F%2Fraw.githubusercontent.com%2FJiangNanGenius%2Ffloe-agent%2Fmain%2Ffeather.json&r=feather"><img src="https://raw.githubusercontent.com/JiangNanGenius/floe-agent/HEAD/docs/images/badge-add-to-feather.png" alt="Feather에 추가하기" height="52"></a>
<a href="https://altdirect.app/?url=https%3A%2F%2Fraw.githubusercontent.com%2FJiangNanGenius%2Ffloe-agent%2Fmain%2Ffeather.json&r=altstore"><img src="https://raw.githubusercontent.com/JiangNanGenius/floe-agent/HEAD/docs/images/badge-add-to-altstore.png" alt="AltStore에 추가하기" height="52"></a>
</p>
<p align="center">
<a href="https://github.com/JiangNanGenius/floe-agent/releases"><strong style="font-size: 1em;">릴리스 다운로드</strong></a>
</p>
<details>
<summary>소스 URL 수동 복사하기</summary>
</details>
| 채널 | 설치 전 준비 사항 |
|---|
| iOS / iPadOS · TestFlight | 유효한 베타 접근 권한 필요. 사용 가능한 빌드 및 만료일은 TestFlight에서 확인 가능합니다. |
| ... | |
| For 첫 번째 iOS / iPadOS 작업을 수행하려면: 설치 → 모델 연결 → 작업 생성 → 결과 열기입니다. Core Notes, 파일 정리 및 Canvas는 AI 제공업체 없이 작동하며; AI 기능은 구성된 제공업체 또는 장치가 지원하는 로컬 모델을 사용합니다. Android의 경우: 설치 → 클라우드 제공업체 키 추가 → 채팅 시작합니다. | |
설치 단계 · 모델 설정 · 소스 및 서명
기능 (Features)
아래의 기능들은 Floe의 핵심 워크플로우를 설명합니다. 사용 가능 여부는 플랫폼과 릴리스에 따라 다릅니다. 위의 설치 참고 사항과 현재 Android 알파 버전(https://github.com/JiangNanGenius/floe-agent/releases/tag/android/v0.1.0-alpha.1)를 참고하십시오.
| 워크플로우 | 할 수 있는 작업 | 가이드 |
|---|
| AI 작업 | 자료, 도구 액션 및 결과 파일과 함께 작업을 계속할 수 있습니다. | 작업 및 워크스페이스 |
| ... | | |
| 클라우드 모델 요청은 선택한 제공업체로 직접 전송되며, 지원되는 로컬 모델은 장치에서 추론을 실행합니다. 자격 증명(Credentials)은 장치 키체인에 보관됩니다. 파일, 업로드 및 원격 작업은 작업 권한을 따르며, 결과적인 액션은 현재 정책 하에 확인됩니다. 보안을 참조하십시오. | | |
Floe 작동 방식 보기
iOS에서 녹화되었으며, Android 알파 버전에서는 위에서 설명된 기본 기능을 다룹니다.
Watch Floe: tasks, Office, code, Notes and Canvas
YouTube에서 시청하기 · Bilibili 중국어 버전 · 웹사이트에서 기능 살펴보기
문서화
소스에서 빌드하기
macOS, 전체 Xcode 설치, Swift 및 XcodeGen을 사용하십시오. 현재 iOS 27 경로는 Xcode 27이 필요하며, iOS/iPadOS 26은 호환성 목표로 남아 있습니다.
git clone https://github.com/JiangNanGenius/floe-agent.git
cd floe-agent/FloeAgent
bash scripts/gen_project.sh
...
종속성(dependencies), 빌드 매개변수 및 집중 테스트는 엔지니어링 가이드를 참조하십시오. Android 앱의 경우, FloeAndroid/README.md를 참조하십시오. Gitee가 소스 및 릴리스 기록을 동기화합니다. 동기화 가이드를 참조하십시오.
기여 및 라이선스
이슈를 보고하거나 프로젝트에서 작업하기 전에 기여(contributing)를 읽어보십시오. 일반적인 질문은 지원(support)을 사용하고 취약점은 보안를 통해 비공개로 보고하십시오.
원본 Floe 코드는 MPL 2.0 라이선스 하에 배포됩니다. 타사 구성 요소는 자체 라이선스와 고지 사항을 유지하며, 이는 앱의 설정(Settings) → 진단 및 정보(Diagnostics & About) → 타사 라이선스(Third-Party Licenses)에서 확인할 수 있습니다.