Mangi-11/Eta

Eta – Android 수준의 AI 어시스턴트

개요

• Eta는 스마트폰을 시스템 전체에 걸친 AI 에이전트로 바꾸는 Android 앱입니다. 사용자가 구성한 대규모 언어 모델(LLM)(OpenAI, Anthropic, Kimi 등)이 기기와 상호 작용하는 도구 호출을 발행할 수 있습니다: 알람 설정, 미디어 제어, 알림 읽기, 셸 명령 실행, 파일 편집, 접근성 서비스를 통한 다른 앱 조작(“GUI 에이전트”)까지 가능합니다.
• 핵심은 에이전트 런타임입니다. 모델이 사용자 프롬프트를 수신하고, 호출할 도구를 결정하고, 앱이 도구를 실행하고, 결과를 모델에 다시 피드백하고, 작업이 완료될 때까지 반복하는 루프입니다.

주요 기능

카테고리	Eta가 할 수 있는 일
시스템 API	직접 Android API 호출: 알람, 볼륨, 미디어, 앱 정보, 권한, 로그(루트 전용).
GUI 에이전트	접근성 트리를 사용하여 UI 요소를 찾고, 클릭, 스크롤, 입력, 전체 해상도 스크린샷 캡처를 수행합니다.
터미널	Linux 스타일 셸(PRoot/chroot를 통한 Alpine 또는 Debian) 제공. 모델은 terminal, terminal_job, terminal_daemon 명령을 실행하고, 출력을 확인하고, 백그라운드 작업을 유지할 수 있습니다.
파일 도구	파일 읽기/쓰기, 검색, 크기 제한 있는 편집, 메타데이터 보기, Android 디렉토리를 /workspace/mounts/로 노출.
브라우저	내장 WebView로 페이지 로드, 텍스트 읽기, DOM 조작, 스크린샷 캡처 가능.
개인 컨텍스트	최근 알림, 앱 사용량, 연락처, 캘린더, 사진, SMS, 건강 데이터(일부는 루트 또는 OEM 지원 필요).
메모리	로컬 MEMORY.md 파일에 장기 대화 컨텍스트 저장; 앱에서 편집, 삭제, 비활성화 가능.
스킬 및 MCP	GitHub 또는 ZIP 파일에서 재사용 가능한 “스킬” 팩 설치; HTTP 및 베어러 토큰(MCP)으로 원격 도구에 연결.
역할	캐릭터 카드(PNG/JSON)를 로드하여 어시스턴트에 페르소나 부여; 역할별 메모리는 일반 채팅과 분리되어 유지.

작동 방식

1. 모델 선택 – 설정에서 공급자를 추가하고 API 키를 제공합니다(BYOK). 많은 공급자를 지원하며 사용자 정의 OpenAI 호환 엔드포인트를 추가할 수 있습니다.
2. 도구 호출 – LLM은 각 도구의 스키마(예: set_alarm(time), read_file(path))를 수신합니다. 도구가 필요하다고 판단하면 Eta는 해당 Android 또는 Linux 구현을 호출하고, 권한을 확인하고, 작업을 실행하고, 구조화된 결과를 반환합니다.
3. 런타임 루프 – 에이전트 런타임은 스트리밍 응답, 유도, 취소, 증분 기록을 관리합니다. 모든 작업은 로컬에 기록됩니다. 민감한 도구 매개변수는 대화를 내보내지 않는 한 저장되지 않습니다.
4. 진입점 – 전원 버튼 길게 누르기에서 시작하거나 OEM 어시스턴트를 가로채기( “小布” / “超级小爱” 용 Xposed 모듈)로 시작할 수 있습니다. 깊은 시스템 통합에는 LSPosed가 필요합니다.

설치 및 사용 방법

• Releases 페이지에서 APK를 다운로드하여 Android 13+에 설치합니다.
• 모델 공급자를 구성하고 필요한 도구를 활성화합니다(GUI용 접근성 서비스, 알림 권한, 위치 등).
• 채팅을 시작하고 요청을 입력하거나 음성으로 말합니다(예: “내일 회의를 예약하고 의제를 연락처에 보내”). Eta가 적절한 도구를 호출하고, 상태 캡슐에 진행 상황을 표시하고, 최종 답변을 반환합니다.

대상 사용자

• 스마트폰에서 프로그래밍 가능한 크로스 앱 어시스턴트를 원하는 고급 사용자.
• 루트 없이 Android에서 LLM 기반 자동화를 실험하려는 개발자(루트는 추가 기능 제공).
• 언어 모델용 자체 API 키를 제공할 수 있는 사람.

제한 사항

• AI 부분은 외부 서비스에서 실행됩니다. Eta에는 로컬 모델이 포함되지 않습니다.
• 일부 개인 데이터(SMS, 캘린더, 건강)는 루트 또는 OEM 특정 후크가 필요합니다.
• Xposed/LSPosed 통합은 선택 사항입니다. 없으면 시스템 어시스턴트 진입점을 잃게 됩니다.
• 라이선스는 비상업용이므로 작성자의 허가 없이 앱을 판매하거나 재배포할 수 없습니다.

중요성 Eta는 데스크톱급 코딩 에이전트(전체 파일 시스템 및 셸 액세스 보유)와 일반적으로 단순한 질문 응답에 제한되는 모바일 어시스턴트 사이의 간극을 메웁니다. Android API와 Linux 터미널을 LLM에 노출함으로써 스마트폰에서 진정한 에이전트적 워크플로우를 가능하게 합니다. 예를 들어, 여러 앱에서 데이터를 자동으로 수집하고, 스크립트로 처리하고, 결과에 따라 작업을 수행하는 것을 모두 자연어 프롬프트로 수행할 수 있습니다.

---

위 정보는 모두 저장소의 README에서 직접 가져왔습니다.