이미 맥에 들어있던 무료 AI를 터미널로 꺼내 쓰는 도구, apfel

macOS 26(Tahoe)부터 모든 Apple Silicon Mac에는 Apple Intelligence의 언어 모델이 내장되어 있다. 그러나 대부분의 사용자는 이 무료 AI를 활용하는 방법을 모른다. apfel은 Apple의 FoundationModels 프레임워크를 래핑해 터미널 명령어, OpenAI 호환 HTTP 서버, 인터랙티브 채팅이라는 방식으로 온디바이스 AI를 쓸 수 있게 해주는 오픈소스 도구다.

맥 안에 잠들어 있던 언어 모델

macOS 26에서 Apple은 FoundationModels라는 Swift API를 통해 시스템 내장 언어 모델인 SystemLanguageModel에 대한 접근을 개방했다. 이 모델은 Neural Engine과 GPU에서 추론을 수행하며, 네트워크 연결이 전혀 필요 없다. API 키도, 클라우드 서비스 구독도 불필요하다.

그러나 FoundationModels 프레임워크는 Swift API로만 제공되기 때문에, 터미널에서 빠르게 활용하거나 기존 개발 파이프라인에 통합하려면 별도의 래퍼가 필요하다. apfel은 이 간극을 메우는 도구로, Swift 6.3으로 작성된 경량 바이너리를 통해 Apple의 내장 AI를 누구나 쉽게 쓸 수 있도록 한다.

⤢✕

CLI든 서버든 채팅이든, 창구는 하나

apfel은 하나의 바이너리로 여러 사용 모드를 제공한다. UNIX CLI 모드에서는 stdin/stdout을 통해 텍스트를 주고받을 수 있어 셸 스크립트나 파이프라인에 자연스럽게 통합된다. echo "이 코드를 설명해줘" | apfel처럼 단순한 파이프로 AI를 호출할 수 있다.

OpenAI 호환 HTTP 서버 모드는 Hummingbird 웹 프레임워크 기반으로 구축되었으며, /v1/chat/completions 엔드포인트를 제공한다. 기존에 OpenAI API를 쓰는 스크립트나 도구를 수정 없이 apfel로 전환할 수 있다는 뜻이다. API 키 비용을 절약하면서도 기존 워크플로우를 유지할 수 있는 실용적인 선택지다.

인터랙티브 채팅 모드에서는 컨텍스트를 유지하면서 연속적인 대화를 나눌 수 있다. 4,096 토큰의 컨텍스트 윈도우 내에서 이전 대화 내용을 참조하며 응답을 생성한다.

잘하는 일과 못하는 일

Apple 내장 모델은 범용 대형 모델과 비교하면 규모가 작지만, 특정 작업에서는 충분한 성능을 발휘한다. apfel이 강점을 보이는 영역과 한계가 명확한 영역은 다음과 같다.

강점 영역	한계 영역
셸 스크립트 생성	수학 연산
텍스트 변환 및 분류	사실 기반 질의응답
짧은 요약 작성	긴 대화 유지
JSON 구조 변환	복잡한 코드 생성
번역 작업	장문 창작

4,096 토큰의 컨텍스트 윈도우는 복잡한 작업에는 제약이 되지만, 일상적인 텍스트 처리 작업에서는 충분하다. 로컬 실행으로 인한 지연 시간 최소화와 비용 제로라는 장점이 성능 제약을 상쇄한다. 도구 호출(tool calling)도 지원해 외부 함수를 연결하는 에이전트 패턴도 구현 가능하다.

⤢✕

전송되지 않는다는 확신

apfel의 가장 중요한 특성 중 하나는 완전한 프라이버시 보장이다. 모든 추론이 Neural Engine과 GPU에서 로컬로 수행되므로 텍스트 데이터가 디바이스 외부로 전혀 전송되지 않는다. 기업 내부 문서를 요약하거나 민감한 코드를 분석할 때 클라우드 기반 AI 서비스를 쓰기 어려운 환경에서 특히 유용하다.

apfel은 GitHub에서 Apache 라이선스로 공개되어 있으며, 2026년 4월 기준 완전 무료로 제공된다. 유료 티어도, 프리미엄 기능 제한도, 텔레메트리도 없다. 소스코드가 공개되어 있어 보안 감사가 가능하고, 커뮤니티 기여를 통해 기능이 확장되고 있다. Hacker News에서 큰 관심을 받으며 개발자 커뮤니티에서 빠르게 확산 중이다.

설치 한 줄, 설정 없음

apfel의 설치는 Homebrew를 통해 한 줄로 끝난다. Apple Silicon Mac과 macOS 26 이상이 필수 요구 사항이며, Intel Mac에서는 FoundationModels 프레임워크가 지원되지 않아 쓸 수 없다. 설치 후 별도의 설정이나 API 키 등록 없이 바로 쓸 수 있다.

HTTP 서버 모드를 실행하면 localhost:8080에서 OpenAI 호환 API가 작동하며, 기존 Python 스크립트에서 base_url만 바꾸면 로컬 AI로 전환할 수 있다. 프로토타이핑 단계에서 API 비용을 절약하면서 개발 속도를 유지하는 데 효과적이다.

클라우드와 로컬을 나눠 쓰는 법

apfel은 macOS에 이미 내장된 무료 AI를 터미널과 HTTP API로 활용할 수 있게 해주는 오픈소스 도구다. FoundationModels 프레임워크를 래핑해 CLI, OpenAI 호환 서버, 인터랙티브 채팅을 제공하며, 네트워크 연결이나 API 키 없이 완전한 로컬 추론을 수행한다. 복잡한 작업에는 클라우드 LLM을, 일상적인 텍스트 처리에는 apfel을 활용하는 하이브리드 전략이 비용 효율과 프라이버시를 동시에 확보하는 현실적인 접근이다.