Mia Agent

터미널 인터페이스 및 세션 관리

• ratatui 기반의 미니멀한 터미널 UI를 제공합니다.
• 설정 가능한 반복 횟수 제한이 있는 다중 턴 에이전트 루프를 지원합니다.
• 세션 간에 유지되는 에이전트 메모리 기능을 포함합니다.
• 마지막 세션을 자동으로 불러오는 세션 기록 기능을 제공하며 mia session list 및 mia session clear로 관리할 수 있습니다.
• termimad를 통한 터미널 내 전체 마크다운 렌더링을 지원합니다.
• 기본 활성화된 스트리밍 응답과 함께 토큰 사용량을 표시합니다.
• 기존 reedline 기반 TUI는 숨겨진 mia old-tui 명령으로 접근할 수 있습니다.

다중 LLM 제공자 지원

OpenAI 호환 API를 통해 다양한 제공자를 사용할 수 있습니다.

• OpenRouter(기본값, 권장)
• OpenCode Zen
• Google AI Studio
• Groq
• Cerebras
• Ollama, LMStudio, llama.cpp 등 OpenAI 호환 로컬 LLM

웹 검색 및 문서 도구

• Tavily를 이용한 웹 검색 및 웹 페이지 내용 추출을 지원합니다.
• pandoc을 활용한 doc_convert 도구로 문서 형식 간 변환이 가능합니다.
• 마크다운 및 LaTeX으로부터 문서를 생성하는 doc_create 도구를 제공합니다.

내장 도구 목록

• datetime: 현재 날짜와 시간을 조회합니다.
• fs_list_dir: 디렉터리 내 파일 목록을 확인합니다.
• fs_read_file: 파일 시스템에서 파일 내용을 읽습니다.
• fs_grep_files: 파일 내용에서 텍스트를 검색합니다.
• fs_search_dirs: 디렉터리에서 파일을 검색합니다.
• fs_write_file: 파일에 내용을 씁니다(권한 필요).
• exec_python: Python 3 코드를 실행합니다(권한 필요).
• exec_shell: 셸 명령을 실행합니다(권한 필요).
• memory: 사용자와 에이전트에 대한 메모리를 관리합니다.
• web_extract: URL에서 내용을 추출합니다.
• web_search: 웹을 검색합니다.
• doc_create: PDF, DOCX 등 문서를 생성합니다.
• doc_convert: pandoc으로 문서를 변환합니다.

권한이 필요한 도구는 실행 전 사용자 승인을 요구합니다.

사전 빌드된 바이너리 사용

Linux(x86_64)와 Windows(x86_64)용 사전 빌드 바이너리가 GitHub 릴리스 페이지에서 배포됩니다. 새 터미널에서 mia setup을 실행해 에이전트를 설정한 뒤 바로 사용할 수 있습니다.

cargo를 사용한 설치 (Windows/Linux)

Mia는 Rust nightly가 필요합니다.

먼저 툴체인을 설치합니다.

그런 다음 cargo를 통해 빌드 및 설치합니다.

설치 후 mia setup을 실행해 구성을 진행합니다.

nix flakes 사용 (NixOS/Linux)

해당 명령으로 시스템을 시험해 볼 수 있으며, 같은 flake을 시스템 패키지에 추가해 설치할 수 있습니다.

환경 설정

대화형 설정 마법사인 mia setup을 실행하면 모델, TUI, 에이전트 관련 설정을 단계별로 진행할 수 있습니다. mia setup은 --model, --tui, agent 옵션으로 특정 섹션만单独 실행하도록 선택할 수도 있습니다.

API 키 구성

고급 설정을 위해 환경 구성 파일을 직접 수정할 수 있습니다. Linux에서는 ~/.mia/.env, Windows에서는 C:Users<username>.mia.env 파일에 다음과 같이 API 키를 추가합니다.

OpenRouter를 사용할 경우:

다른 제공자를 사용할 경우 해당 환경 변수를 설정합니다. 웹 검색과 웹 추출 도구를 사용하려면 Tavily API 키를 추가합니다.

도구 점검

mia tools 명령으로 필요한 도구들이 모두 사용 가능한지 확인하고, 누락된 구성 요소를 확인할 수 있습니다.

주요 CLI 명령

• mia tui: 기본 ratatui 기반 터미널 UI 시작
• mia old-tui: 기존 reedline 기반 TUI 시작(숨겨진 명령)
• mia setup: 대화형 설정 마법사
• mia tools: 도구 사용 가능 여부 확인
• mia model list: 사용 가능한 모델 목록 표시
• mia model list --free: 무료 모델만 표시
• mia model list --min-context <number>: 최소 컨텍스트 길이로 필터링(128k, 4M 등 표기 가능)
• mia model list --max-price <price>: 백만 토큰당 최대 가격으로 필터링
• mia model show: 현재 모델 정보 표시
• mia sessions list: 세션 목록 표시
• mia session clear: 모든 세션 삭제(확인 절차 포함)

Mia Agent는 무료인가요?

소스 코드는 GitHub에 공개되어 있으며 MIT 라이선스로 배포됩니다. 단, OpenRouter, OpenCode Zen, Google AI Studio, Groq, Cerebras 등 LLM 제공자나 Tavily 등 외부 서비스를 사용할 경우 해당 제공자의 API 키와 사용 정책이 필요합니다.

Mia Agent는 어떤 용도로 사용할 수 있나요?

터미널 기반 AI 어시스턴트로, 개인 코딩 보조, 파일 검색과 읽기, 문서 변환과 생성, 웹 검색 및 내용 추출 등 다양한 작업에 활용할 수 있습니다.

어떤 운영체제에서 동작하나요?

사전 빌드 바이너리는 Windows와 Linux(x86_64)를 지원하며, cargo 및 nix flakes를 통한 설치 방법도 제공됩니다.

외부 도구가 꼭 필요한가요?

Python, Ripgrep, fd, pandoc은 Mia의 여러 도구 기능이 동작하기 위해 필요한 외부 구성 요소입니다. mia tools 명령으로 어떤 구성 요소가 누락되었는지 확인할 수 있습니다.

화면으로 보는 주요 기능

MIA 로고 화면

검은색 배경 위에 분홍색으로 'MIA'라는 글자가 픽셀 아트 스타일로 표시되어 있으며, 각 문자 주변에 연한 녹색의 경계선이 보인다.