niki914/zafiro

Zafiro는 Android 기기에서 실행되는 오픈 소스 지능형 Agent로, BYOK(Bring Your Own Key)를 지원합니다. 사용자의 화면을 이해하고 장치를 제어하며, Skills, MCP, 메모리 전반에 걸쳐 앱 간 작업을 수행할 수 있습니다. 또한 Shell 및 Python 3을 네이티브로 실행할 수 있으며, 웹 검색이나 파일 다운로드와 같은 작업을 수행하거나 SSH를 통해 원격 개발 머신에 연결하기 위해 자체적으로 도구를 감싸서(wrap) 사용할 수도 있습니다.

|
|
|
|
| Device Control | Research | Install Apps from the Web | Settings |

중요 사항 (Important)
Zafiro는 Shizuku를 통해 실행되며, Root 권한이 필요하지 않습니다. Root 사용자는 모든 기능을 사용할 수 있습니다.

릴리스(Releases)에서 릴리스 버전을 다운로드하거나 소스 코드로부터 빌드할 수도 있습니다.

Material 3 Expressive & Apple Liquid Glass - 현대적이고 세련된 인터페이스
개인화된 테밍 (Personalized Theming) - 다크 모드를 포함한 여러 테마 색상 및 동적 색상 추출 지원
다국어 지원 (Multilingual Support) - 영어, 중국어(中文), 일본어(日本語), 스페인어(Español)
배경 상호작용 (Background Interaction) - Agent를 실시간으로 따라가고 상호 작용하는 세련된 플로팅 볼 및 알림 트레이 UI

화면 상호작용 (Screen Interaction) - 앱 열기, 음악 선택, 음식 주문 등 모든 작업을 대신 처리해 줍니다.
완벽한 가시성 (Fully Visible) - 화면상의 마우스가 Agent가 취하는 모든 단계를 보여줍니다.

즉시 사용 가능 (Out-of-the-Box) - OpenAI, Anthropic, Google Gemini, DeepSeek, OpenRouter, Kimi, Alibaba Bailian, SiliconFlow 등 다수의 모델을 기본 지원합니다.
필요에 따라 확장 (Extend as Needed) - Skills 및 MCP에 대한 완벽한 지원과 메모리, 작업 공간(workspace)을 제공하여 원하는 방식으로 확장할 수 있습니다.
권한 관리 (Permission Management) - 설정 가능한 규칙으로 모든 명령어와 코드가 사용자의 통제 하에 있습니다.
대화 제어 (Conversation Control) - 언제든지 이전 내용 되돌리기(rewind), 편집, 재생성할 수 있으며; 모든 대화 데이터는 엄격하게 로컬에 보관되며, 모델은 동일 세션 내에서 실시간으로 전환할 수 있습니다.

코드 직접 실행 (Run Code Directly) - 기기에서 Python 3을 네이티브로 실행합니다.
메타-도구링 (Meta-Tooling) - 사용자가 자체 Python 도구를 감싸서(wrap) 사용할 수 있으며; Agent는 생성한 도구를 재사용하고 유지 관리합니다.
내장 시나리오 (Built-in Scenarios) - 웹 검색, 웹 페이지 읽기, APK 설치 기능이 기본으로 작동합니다.

Termux - Android 기기에서 리눅스 명령어 및 도구 사용
SSH - 원격 작업을 실행하기 위해 개발 머신 또는 서버에 연결
Claude Code - 원격 코딩 에이전트가 실행하는 휴대폰에서의 개발 작업 요청

LSPosed 프레임워크를 통해 Zafiro는 시스템 음성 비서 기능을 장악할 수 있습니다. Breeno나 XiaoAi를 깨우면, 실제로 답변하는 것은 사용자의 Agent입니다. 키워드를 기반으로 어떤 요청은 Zafiro로 보내고 어떤 요청은 네이티브 비서에게 전달할지 결정할 수 있습니다. 장악 후에도 비서는 기기 제어를 포함한 모든 Agent 기능을 유지합니다.

참고 사항

시스템 음성 비서 기능 장악을 위해서는 Root + LSPosed가 필요하며, 현재 OPPO - Breeno를 지원합니다.

음성 장악 가능 여부는 휴대폰 모델, 시스템 버전, 음성 비서 버전 및 벤더 시스템 제한에 따라 달라질 수 있습니다. 기기가 아직 시스템 비서 장악을 지원하지 않더라도 Zafiro의 채팅 인터페이스를 모든 Agent 기능과 함께 사용할 수 있습니다.

./gradlew assembleDebug

• Android Studio (또는 Android SDK + JDK 17)
• Android 11 이상 장치

릴리스 서명(Release Signing)

직접 릴리스 버전을 빌드하려면 자체 서명 키를 사용하세요:

keytool -genkeypair -v -keystore my-release.jks \
-keyalg RSA -keysize 2048 -validity 10000 -alias my_key
./gradlew assembleRelease \
...

./
├── app/ # 메인 앱: Compose UI, AgentRuntimeService, Xposed hooks
├── business/ # 핵심 비즈니스 계층 (계약과 구현 분리)
...

• 시스템 음성 비서 통합 (비-Xposed 장악)
• 외부 앱에서의 파일 가져오기 / 공유
• Termux와 같은 내장 스킬,
  /skill
  힌트, 클라우드 스킬 임포트

풀 리퀘스트(Pull requests) 환영합니다!

• 이 프로젝트 포크하기

• 기능 브랜치 생성 (git checkout -b feat/your-feature)

• 변경 사항 커밋 (git commit -m 'feat: add your feature', Conventional Commits 따르기)

• 브랜치에 푸시 (git push origin feat/your-feature)

• 풀 리퀘스트 열기

• Telegram — 토론하고 질문하거나 피드백을 제공하세요

• GitHub Issues — 버그를 보고하거나 기능을 요청하세요

• Afdian — 개발자를 지원하세요

이슈를 보고하실 때는 가능한 한 많은 세부 정보를 포함해 주세요: 휴대폰 모델 및 Android 버전, 시스템 음성 비서 및 그 버전, Zafiro 버전, 재현 단계, 그리고 스크린샷 또는 화면 녹화본.

MIT — LICENSE를 참고하세요.

✨️ niki914가 제작했습니다