IRIS
월 구독 없이 내 PC에서 쓰는
오픈소스 AI 에이전트
01해결하려는 문제
AI 에이전트를 써 보고 싶어도
돈이 들거나 설치가 어렵습니다
에이전트 도구는 대부분 월 구독입니다. 무료로 쓰려면 모델 런타임과 에이전트를 직접 설치하고 서로 연결해야 하는데, 코딩을 막 배우기 시작한 사람에게는 쉽지 않습니다.
대상 학생 · 취업 준비생 · 코딩 입문자
02IRIS가 하는 일
설치와 연결은
IRIS가 합니다
IRIS는 Windows용 데스크톱 앱입니다. 모델을 돌리는 Ollama와 도구를 실행하는 Hermes Agent를 설치해서 연결하고, 채팅창 하나에서 쓸 수 있게 해 줍니다.
설치
setup.bat이 파이썬 가상환경과 패키지를 준비하고, 앱을 처음 켜면 시작 프로토콜이 Ollama·모델·Hermes 설치를 이어서 진행합니다.
채팅이나 음성으로 작업
할 일을 적거나 말하면 Hermes가 파일을 고치고 터미널 명령을 실행합니다. 어떤 도구를 썼는지는 Live Activity 로그에 남습니다.
창 감시
지정해 둔 창이 승인을 기다리거나 에러로 멈추면 IRIS가 알림을 띄웁니다.
Live Activity / Internal Log
예시 로그입니다. 실제 화면은 06 시연 영상에서 볼 수 있습니다.
03AI 활용 방식
Ollama가 생각하고
Hermes가 실행합니다
웹 검색이나 파일·터미널 도구는 새로 만들지 않고 Hermes Agent의 도구를 씁니다. IRIS 코드는 대화 세션, 권한 확인, 화면 표시, 설치 과정을 맡습니다.
Ollama 모델
요청을 읽고 어떤 도구를 쓸지 정합니다. OpenAI 호환 /v1 API로 호출해서 로컬 모델과 클라우드 모델을 같은 코드로 씁니다.
Hermes Agent
파일 읽기·수정, 터미널 명령, 웹 검색을 실제로 실행합니다. 모델의 추론 과정과 도구 로그는 HUD에 바로 표시됩니다.
멀티모달 모델
고정한 창을 최대 3개까지 캡처해서 승인 대기, 에러, 작업 멈춤 등 9가지 상태 중 하나로 판정합니다. 스크린샷 원본은 저장하지 않습니다.
MCP
IRIS가 켜질 때 Hermes에 iris-control MCP 서버를 등록합니다. 그래서 에이전트가 IRIS의 캘린더, 위키, 메일, 에뮬레이터를 직접 다룰 수 있습니다.
선택 확장 음성 대화 (faster-whisper · Silero VAD · Qwen3-TTS) · 시연 학습 (ShowUI-Aloha)
04사용한 AI 도구
사용 중인
AI 모델
iris-control(IRIS UI 조작) · mobile-mcp(Android 에뮬레이터 조작)만들 때 쓴 AI
전체 커밋 93개 중 AI 작성 기록이 남은 커밋
- Cursor48
- Claude Code14
- 기록 없음31
HUD, 시작 프로토콜, 음성, IDE Companion은 주로 Cursor로 만들었습니다. 설치 스크립트, 창 모니터, 전화 알림, 라이선스 정리와 이 페이지는 Claude Code(Claude Opus 5)로 작업했습니다.
* git 커밋의 Co-authored-by·작성자(Cursor Agent) 기록 기준 · 2026-07-20 ~ 09-15
06시연
실제로 써 본 3분 30초
바탕화면에서 IRIS를 켜고 시작 프로토콜을 거친 뒤, 음성으로 대화하고 캘린더·위키·메일·에뮬레이터를 열어 봅니다. 마지막에는 IDE에서 테트리스 게임에 기능을 추가해 달라고 시킵니다.
07설치와 첫 실행
설치 파일 하나로
시작합니다
설치 프로그램이 파이썬 확인부터 패키지 설치까지 알아서 준비합니다. 중간에 실패하면 이유와 해결 방법을 화면에 보여 줍니다.
IRIS-Setup.exe 내려받기IRIS 실행* 소스에서 직접 설치하려면 ZIP 을 받아 setup.bat 을 실행합니다. 설치가 중간에 끊겼을 때도 같은 파일로 이어서 복구합니다.
START PROTOCOL
필수 환경을 순서대로 준비합니다. 직접 입력이 필요한 단계에서만 안내창이 뜹니다.
- ·Python 환경 확인
py -3.13/-3.12/-3.11순으로 찾고, 없으면 설치 링크와 winget 명령 안내 - ·가상환경 · 패키지 설치
.venv생성 후requirements.txt설치, 사내망용 대체 명령 제공 - ·핵심 패키지 import 검증실패하면 VC++ 재배포 패키지 설치 명령 안내
- ·Ollama 설치 · 추론 모델 준비공식 설치 스크립트로 Ollama를 켜고, 최소 로컬 모델을 받거나 Ollama 클라우드 로그인 확인
- ·Hermes 설치 · Ollama 연결Hermes 설치, API 키·서버 설정, iris-control MCP 등록, gateway 기동
- ·선택 항목음성 · 화면 학습 · 에뮬레이터 · mobile-mcp 는 「설치」 또는 「나중에」
OSWindows 10/11RAM8GB · 권장 16GBGPU불필요DISK약 20GB
* 기본 구성은 클라우드 모델을 써서 GPU가 없어도 됩니다. 큰 로컬 모델, 에뮬레이터, 화면 학습은 더 높은 사양이 필요합니다.
08확장성
기능은 스킬과
MCP 서버로 추가합니다
에이전트가 할 수 있는 일은 Hermes 스킬이나 MCP 서버를 추가해서 늘립니다. 대부분은 IRIS 코드를 고치지 않아도 됩니다.
IRIS가 켜질 때 스킬 10개를 Hermes에 동기화합니다. 스킬 폴더를 하나 추가하면 에이전트가 쓸 수 있는 기능도 하나 늘어납니다.
Hermes 설정의 mcp_servers에 등록하는 일반 MCP 서버입니다. 지금은 iris-control과 mobile-mcp를 쓰고, 다른 서버도 같은 방법으로 붙일 수 있습니다.
Ollama 모델만 바꾸면 로컬 모델과 클라우드 모델, 작은 모델과 큰 모델을 바꿔 쓸 수 있습니다.
Eclipse Theia 기반 IRIS IDE와 Companion 패널이 들어 있습니다. Open VSX 확장도 설치할 수 있습니다.
음성 대화, 화면 학습, Android 에뮬레이터(전화 수신 감지·응답 포함)는 필요할 때만 따로 설치합니다.
GPL-3.0-or-later로 공개했습니다. 포크해서 스킬이나 MCP 연동을 추가할 수 있습니다.
09기술 스택과 규모
2026년 7월 20일 첫 커밋부터 9월 15일까지 기준입니다.
- UI
- Python · PyQt6 · PyQt6-WebEngine
- 모델
- Ollama (OpenAI 호환
/v1) - 에이전트
- Hermes Agent (gateway API · skills · MCP)
- IDE
- Eclipse Theia 1.74 · Open VSX
- 음성
- faster-whisper · Silero VAD · Qwen3-TTS (선택)
- 저장
- SQLite
~/.iris-light/· Obsidian 호환 vault - 배포
setup.bat자동 설치 ·dist/IRIS.exe
UI를 PyQt6로 만들었는데, PyQt6는 상업 라이선스를 사지 않으면 GPL-3.0-only입니다. 저장소에서 PyQt6가 들어간 dist/IRIS.exe를 직접 배포하기 때문에 이 조건을 따라야 합니다.
그래서 MIT나 Apache-2.0은 쓸 수 없었고 GPL-3.0-or-later로 정했습니다. 서드파티 라이선스 목록은 저장소 LICENSE.md에 있습니다.
10기대 효과
진입장벽 없는
AI 에이전트
월 구독 없이 시작할 수 있습니다.
코딩, 문서 작성, 파일 정리를 내 PC에서 에이전트에게 직접 시켜 보면서 익힐 수 있습니다.
PC 사양에 맞춰 로컬 모델이나 클라우드 모델을 고를 수 있습니다.
설정, 프로필, 노트는 내 PC에 저장됩니다.