readme_ko.md

   

---

🚀 AI와 함께 협업하세요 - Gemini CLI, Claude Code, Codex, Qwen Code, Goose CLI, Auggie 등
사용자 친화적 | 시각적 그래픽 인터페이스 | 다중 모델 지원 | 로컬 데이터 보안

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Português | 공식 웹사이트 | Twitter

💬 커뮤니티: Discord (English) | 微信 (中文群)

---

📋 빠른 탐색

✨ AionUi로 무엇을 할 수 있나요? · 🤔 왜 AionUi를 선택해야 하나요? · ✨ 핵심 기능 · 🚀 빠른 시작 · 📖 상세 사용 가이드 · 💬 커뮤니티

---

✨ AionUi로 무엇을 할 수 있나요?

🤖 멀티 에이전트 모드 - 명령줄 AI 도구를 위한 통합 그래픽 인터페이스

AionUi에는 Gemini CLI가 내장되어 있어 다운로드 즉시 사용 가능하며 추가 설치가 필요 없습니다. 이미 Gemini CLI, Claude Code, CodeX, Qwen Code, Goose AI, Augment Code 같은 명령줄 도구를 설치했다면 AionUi가 자동으로 감지해 통합 그래픽 인터페이스를 제공하고 더 풍부한 경험을 제공합니다

• ✅ 자동 감지 + 통합 인터페이스 - 로컬 CLI 도구를 자동으로 인식하고 통합 그래픽 인터페이스를 제공하여 명령줄과 작별
• ✅ 로컬 저장 + 다중 세션 - 대화가 로컬에 저장되고 독립적인 컨텍스트를 가진 다중 병렬 세션 지원

---

🌐 어디서나 접속 - WebUI 모드

당신의 7×24시간 AI 어시스턴트 - 네트워크의 모든 기기에서 AionUi에 접속하세요! 출장 중, 집에서, 사무실에서, 언제 어디서나 AI 도구를 사용하세요

✨ 원클릭 시작：설정 패널에서 WebUI 옵션을 열고 스위치를 클릭하기만 하면 시작됩니다!

• ✅ 크로스 디바이스 접속 - 스마트폰, 태블릿, 컴퓨터, 모든 기기에서 접속 가능
• ✅ 원격 협업 - LAN, 크로스 네트워크, 서버 배포 등 다양한 시나리오 지원
• ✅ 안전하고 신뢰할 수 있음 - 비밀번호 관리, QR 코드 로그인, 데이터는 기기를 떠나지 않습니다

💡 자세한 설정 가이드가 필요하신가요? WebUI 설정 튜토리얼 과 원격 인터넷 접속 가이드 를 확인하세요

webui_compressed.mp4

---

📁 스마트 파일 관리 (AI Cowork)

일괄 이름 변경, 자동 정리, 스마트 분류, 파일 병합

• 자동 정리: 콘텐츠를 지능적으로 식별하고 자동 분류하여 폴더를 깔끔하게 유지합니다.
• 효율적인 일괄 처리: 원클릭 이름 변경, 파일 병합으로 번거로운 수동 작업과 작별합니다.

---

📄 미리보기 패널 - AI 생성 결과 빠르게 확인

9가지 이상의 형식을 시각적으로 미리보기 지원 (PDF, Word, Excel, PPT, 코드, Markdown, 이미지, HTML, Diff 등)

• ✅ 즉시 결과 확인 - AI가 파일을 생성하면 앱을 전환하지 않고 바로 미리보기
• ✅ 실시간 추적 + 편집 가능 - 파일 변경 자동 추적, 편집기와 미리보기 스마트 동기화; Markdown, 코드, HTML 실시간 편집 지원

---

🎨 AI 이미지 생성 및 편집

Gemini 기반의 지능형 이미지 생성, 편집 및 인식

---

💬 다중 작업 병렬 처리

여러 대화 열기, 작업이 섞이지 않음, 독립적인 메모리, 효율 두 배

🎬 클릭하여 데모 보기 ▶️

---

🤔 왜 AionUi를 선택해야 하나요? | Claudebot처럼 편리함

Claude Cowork가 Claude Code를 더 쉽게 사용할 수 있게 해주는 것처럼, AionUi는 모든 명령줄 AI 도구를 위한 Cowork 플랫폼입니다

Gemini CLI, Claude Code, Codex, Qwen Code는 강력하지만 공통적인 문제점이 있습니다: 대화를 저장할 수 없음, 단일 세션 제한, 번거로운 파일 작업, 단일 모델만 지원.

AionUi는 이러한 명령줄 도구에 통합된 Cowork 기능을 제공합니다:

• 🎯 통합 플랫폼 - 하나의 인터페이스로 모든 명령줄 AI 도구 관리, 전환 필요 없음; Gemini CLI 내장, 다운로드 즉시 사용 가능하며 완전 무료
• 🚀 다중 도구 지원 - Claude Code뿐만 아니라 Gemini CLI, Codex, Qwen Code 등도 지원
• 🖥️ 크로스 플랫폼 - macOS, Windows, Linux 전체 플랫폼 지원 (Claude Cowork는 현재 macOS만 지원)
• 🌐 원격 접속 - 당신의 원격 24/7 어시스턴트, 언제 어디서나 접속 가능하며 완전 무료
• 🔄 다중 모델 전환 - 같은 인터페이스에서 다른 모델로 유연하게 전환, 다양한 작업 요구 충족
• 📄 실시간 미리보기 - 9가지 이상의 형식 시각적 미리보기, AI가 생성한 파일 즉시 확인
• 💾 로컬 데이터 보안 - 모든 대화와 파일이 로컬에 저장, 데이터가 기기를 떠나지 않음

---

❓ 빠른 Q&A

Q: AionUi가 Claude Cowork의 좋은 대안인 이유는?

A: AionUi는 **무료 오픈소스** **Multi-AI Agent Desktop**입니다. macOS에서만 실행되고 Claude에만 묶여 있는 공식 Cowork와 비교하여, AionUi는 **전체 모델, 크로스 플랫폼 강화 버전**이며, **AI 오피스 자동화** 시나리오를 깊이 다룹니다.

차원	Claude Cowork	AionUi (이 프로젝트)
OS	macOS만	🍏 macOS / 🪟 Windows / 🐧 Linux
모델 지원	Claude만	🤖 Gemini, Claude, DeepSeek, OpenAI, Ollama
인터랙션	GUI	🖥️ 전체 GUI + WebUI 원격 접속
비용	구독 $100/월	🆓 완전 무료 오픈소스

깊은 AI 오피스 시나리오 지원:

• 파일 관리: 지저분한 로컬 폴더를 지능적으로 정리하고 원클릭 일괄 이름 변경.
• 데이터 처리: Excel 보고서를 깊이 분석하고 자동으로 아름답게.
• 문서 생성: PPT, Word, Markdown 문서를 자동으로 작성하고 형식 지정.
• 즉시 미리보기: 내장 9가지 이상의 형식 미리보기 패널로 AI 오피스 협업 결과를 즉시 확인.

Q: AionUi로 무엇을 할 수 있나요?

A: **개인 Cowork 작업 공간**이 될 수 있습니다. 폴더 일괄 정리, Excel 깊은 아름답게, 실시간 웹 코드 미리보기를 도와줄 수 있습니다. 오피스 자동화 워크플로우를 탐색하고 Claude Code 또는 Gemini CLI 경험을 향상시키는 최고의 그래픽 선택입니다.

Q: AionUi는 바로 사용할 수 있나요?

A: 네! 설치 후 바로 사용할 수 있으며 Gemini CLI가 내장되어 추가 설치가 필요 없습니다. 이미 Gemini CLI 등 명령줄 도구를 사용 중이라면 AionUi가 자동으로 인식해 더 풍부한 경험을 제공합니다.

Q: 무료인가요?

A: AionUi는 완전히 무료이고 오픈소스이지만, AI 모델을 사용하려면 해당 API Key가 필요합니다.

Q: 어떤 AI 모델을 지원하나요?

A: Gemini, OpenAI, Claude, Qwen과 같은 주류 모델과 Ollama, LM Studio와 같은 로컬 모델을 지원합니다.

여러 AI Agent(예: Gemini CLI, Claude Code, Qwen Code 등)를 동시에 실행할 수도 있습니다. 자세한 내용은 설정 가이드를 참조하세요.

Q: 데이터는 안전한가요?

A: 모든 대화 데이터는 로컬 SQLite 데이터베이스에 저장되며 어떤 서버에도 업로드되지 않습니다.

---

🎬 사람들이 AionUi를 어떻게 사용하는지 확인하세요

크리에이터들이 AionUi를 리뷰하고 사용하는 모습을 시청하세요

  

🎬 WorldofAI (20만 구독자)                                                                🎬 Julian Goldie SEO (31.8만 구독자)

💡 AionUi에 대한 영상을 만드셨나요? X에서 알려주세요, 여기에 소개해 드립니다! 여러분의 피드백을 반영하여 지속적으로 개선하겠습니다.

---

✨ 핵심 기능

💬 다중 세션 채팅

• 다중 세션 + 독립적 컨텍스트 - 동시에 여러 채팅 열기, 각 세션은 독립적인 컨텍스트 메모리를 가짐, 혼동 없음
• 로컬 저장 - 모든 대화가 로컬에 저장되어 손실 없음

🌐 WebUI 원격 접속 - 당신의 24/7 AI 어시스턴트

• 크로스 디바이스 접속 - 네트워크의 모든 기기에서 브라우저를 통해 접속, 모바일 기기 지원
• 언제 어디서나 - 출장 중, 집에서, 사무실에서, 7×24시간 언제든 AI 도구에 접속, 완전 무료
• 로컬 데이터 보안 - 모든 데이터가 SQLite 데이터베이스에 로컬 저장, 서버 배포에 적합

🤖 다중 모델 지원

• 다중 플랫폼 지원 - Gemini, OpenAI, Claude, Qwen과 같은 주류 모델 지원, 유연하게 전환
• 로컬 모델 지원 - Ollama, LM Studio와 같은 로컬 모델 배포 지원, Custom 플랫폼을 선택하고 로컬 API 주소(예: http://localhost:11434/v1)를 설정하여 연결
• Gemini 3 구독 최적화 - 구독 사용자 자동 식별, 고급 모델 추천

🗂️ 파일 관리

• 파일 트리 탐색 + 드래그 앤 드롭 업로드 - 폴더처럼 파일 탐색, 파일이나 폴더를 드래그 앤 드롭하여 원클릭 가져오기 지원
• 스마트 정리 - AI가 폴더 정리를 도와주고 자동 분류

📄 미리보기 패널 - AI Agent에게 디스플레이 제공

• 9가지 이상의 형식 미리보기 - PDF, Word, Excel, PPT, 코드, Markdown, 이미지 등 지원, AI 생성 후 즉시 결과 확인
• 실시간 추적 + 편집 가능 - 파일 변경 자동 추적, Markdown, 코드, HTML 실시간 편집 및 디버깅 지원

🎨 AI 이미지 생성 및 편집

• 지능형 이미지 생성 - Gemini 2.5 Flash Image Preview, Nano, Banana 등 다양한 이미지 생성 모델 지원
• 이미지 인식 및 편집 - AI 기반 이미지 분석 및 편집 기능

🎨 개인화된 인터페이스 커스터마이징

나만의 CSS 코드로 커스터마이즈하여 인터페이스를 취향에 맞게

• 완전 커스터마이즈 - CSS 코드를 통해 인터페이스 색상, 스타일, 레이아웃을 자유롭게 커스터마이즈하여 전용 경험 생성

---

📖 상세 사용 가이드

📖 전체 사용 가이드 보기

🚀 빠른 시작

• 📖 전체 설치 가이드 - 다운로드부터 설정까지 상세 단계
• ⚙️ LLM 설정 가이드 - 다중 플랫폼 AI 모델 설정
• 🤖 멀티 에이전트 모드 설정 - 터미널 AI 에이전트 통합
• 🔌 MCP 도구 설정 - 모델 컨텍스트 프로토콜 서버 설정
• 🎨 이미지 생성 설정 - AI 이미지 생성 설정 튜토리얼
• 🌐 WebUI 설정 가이드 - 전체 WebUI 설정 및 구성 튜토리얼

🎯 사용 사례

• 📁 파일 관리 - 스마트 파일 정리
• 📊 Excel 처리 - AI 기반 데이터 처리
• 🎨 이미지 생성 - AI 이미지 생성
• 📚 더 많은 사용 사례
  • 🎬 WorldofAI - YouTube 영상 리뷰
  • 🎬 Julian Goldie SEO - YouTube 영상 리뷰

❓ 지원 및 도움말

• ❓ FAQ - 질문 및 문제 해결
• 🔧 설정 및 사용 튜토리얼 - 전체 설정 문서

---

🚀 빠른 시작

💻 시스템 요구사항

• macOS: 10.15 이상
• Windows: Windows 10 이상
• Linux: Ubuntu 18.04+ / Debian 10+ / Fedora 32+
• 메모리: 4GB 이상 권장
• 저장공간: 최소 500MB 여유 공간

📥 다운로드

🍺 Homebrew로 설치 (macOS)

brew install aionui

🔧 간단한 설치

1. 다운로드 및 설치 AionUi 애플리케이션
2. AI 서비스 설정 - Google 계정 로그인 또는 API Key 인증 지원
3. 사용 시작 - 즉시 현대적인 AI 채팅 인터페이스 경험

💡 자세한 설정 가이드가 필요하신가요? 전체 설치 튜토리얼을 확인하세요

---

🤝 커뮤니티 & 지원

💬 커뮤니티

💡 여러분의 아이디어가 중요합니다! 우리는 모든 사용자의 제안과 피드백을 매우 소중히 여깁니다. 기능 아이디어, 사용자 경험, 문제가 있으시면 언제든 연락해 주세요!

• 💬 GitHub Discussions - 아이디어 공유, 제안하기, 사용 팁 교환
• 🐛 문제 보고 - 버그 또는 기능 요청 보고
• 📦 릴리스 업데이트 - 최신 버전 받기
• 💬 Discord Community - Discord에서 영어 커뮤니티에 가입하세요
• 💬 微信 (中文群) - QR 코드 보기

🤝 기여하기

Issue와 Pull Request를 제출해 주세요!

1. 이 프로젝트를 Fork하세요
2. 기능 브랜치 생성 (git checkout -b feature/AmazingFeature)
3. 변경사항 커밋 (git commit -m 'Add some AmazingFeature')
4. 브랜치에 푸시 (git push origin feature/AmazingFeature)
5. Pull Request 열기

---

📄 라이선스

이 프로젝트는 Apache-2.0 라이선스를 따릅니다.

---

👥 기여자

AionUi에 기여해 주신 모든 개발자분들께 감사드립니다!

📊 Star 히스토리

⭐ 마음에 드시면 Star를 눌러주세요

버그 보고 · 기능 요청