Mu – Micro 개인 비서용 런타임

Mu는 오픈소스 개인 비서인 Micro를 구동하는 셀프 호스팅 런타임입니다. 통합 받은 편지함, 웹 UI, CLI 클라이언트, HTTP API를 제공하여 AI 기반 에이전트와 상호 작용할 수 있게 해줍니다. 에이전트에게는 지침과 서비스 툴박스(메일, 캘린더, 검색, 날씨, 셸 등)가 제공되며, 에이전트는 요청을 완료하기 위해 적절한 도구를 선택합니다.

핵심 개념

개념	설명	사용 방법
Home	계정 생성, LLM 제공업체 선택, 진행 중인 대화 확인을 위한 웹 대시보드 (http://localhost:8080).	서버 시작 후 브라우저에서 URL을 엽니다.
Inbox	HTTP, SMTP, SMS, XMPP에서 오는 메시지의 단일 진입점. 모든 수신 통신은 여기서 스레드로 저장됩니다.	`agent@your-domain`으로 이메일을 보내거나, 설정된 번호로 문자를 보내거나, `/agent`로 POST 요청을 보냅니다.
Agents	AI "두뇌". 기본 에이전트는 Micro입니다. 사용자 지정 지침과 툴셋을 추가하여 에이전트를 확장할 수 있습니다.	UI, CLI (`mu ask …`) 또는 API를 통해 질문합니다. 에이전트가 호출할 서비스 도구를 결정합니다.
Services	에이전트에게 도구를 노출하는 독립형 백엔드(메일 클라이언트/서버, 웹 검색, RSS 뉴스, YouTube 검색, 날씨, 셸 명령 등).	에이전트가 자동으로 이러한 서비스를 호출하며, 직접 탐색할 수도 있습니다.

설치 (빠른 시작)

# 설치 스크립트 다운로드 및 실행
curl -fsSL https://raw.githubusercontent.com/micro/mu/main/install.sh | sh

# 서버 시작 (localhost:8080에서 수신)
~/.local/bin/mu --serve --address 127.0.0.1:8080

브라우저에서 http://localhost:8080을 엽니다.
계정을 생성하고 AI 제공업체(예: OpenAI, Anthropic 등)를 선택합니다.
더 자세한 구성(호스팅, 메일, 개발)은 선택적 문서를 따르십시오.

명령줄 클라이언트

mu 바이너리는 로컬(또는 원격) 서버와 통신하는 경량 클라이언트로 작동합니다.

# 비서에게 질문하기
mu ask "What needs my attention?"

# 받은 편지함의 스레드 목록 보기
mu inbox list

# 도움말 보기
mu help

MU_URL을 사용자 지정 서버로 설정하거나 mu login https://your.host로 한 번 로그인하십시오.

HTTP API

모든 상호 작용은 간단한 REST 엔드포인트로 스크립트화할 수 있습니다.

curl "$MU_URL/agent" \
  -H "Authorization: Bearer $MU_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"What needs my attention?"}'

응답에는 다음이 포함됩니다:

text – 비서의 답변.
thread – 동일한 대화를 계속하기 위해 다시 보내는 식별자.

인증은 베어러 토큰(MU_TOKEN)을 통해 처리됩니다. 유료 서비스 호출(예: 상위 티어 LLM 사용)을 위해 별도의 x402 호스트를 구성할 수 있습니다.

Mu의 차별점

통합 받은 편지함 – 이메일, SMS, XMPP 또는 직접 HTTP에서 오는 메시지가 모두 스레드로 표시됩니다.
플러그인 가능한 서비스 – 코드를 작성하지 않아도 에이전트가 풍부한 도구 세트를 호출할 수 있습니다.
셀프 호스팅 – 전체 스택을 자신의 머신이나 서버에서 실행하여 데이터를 비공개로 유지합니다.
다중 프로토콜 진입점 – 가장 편리한 채널을 사용하여 비서와 상호 작용할 수 있습니다.

다음 단계

전체 설치 가이드 읽기: docs/INSTALL.md
서비스 구성 및 사용자 지정 에이전트는 docs/README.md를 확인하십시오.
저장소의 기여 가이드를 통해 새로운 서비스나 에이전트를 기여하십시오.

Mu는 본질적으로 LLM이 생산적인 도구 사용 에이전트로 작동할 수 있게 해주는 개인 비서 플랫폼이며, 모든 것을 사용자의 통제하에 둘 수 있습니다.

micro/mu