Readme Ko

<em>내장 Agent | 제로 설정 | 모든 API 키 | 멀티 Agent | 원격 접근 | 크로스 플랫폼 | 24/7 자동화</em>

📋 빠른 탐색

✨ Cowork 실연 · 🤔 왜 AionUi를 선택해야 하나요? · 🚀 빠른 시작 · 💬 커뮤니티

Cowork — AI Agents가 함께 작업합니다

AionUi는 단순한 채팅 클라이언트가 아닙니다. 컴퓨터에서 AI Agent가 함께 작업하는 Cowork 플랫폼입니다——파일 읽기, 코드 작성, 웹 브라우징, 작업 자동화. Agent의 모든 동작을 볼 수 있으며, 항상 제어권은 여러분에게 있습니다.

내장 Agent — 설치 즉시 사용, 제로 설정

AionUi는 완전한 AI Agent 엔진을 내장하고 있습니다. CLI Agent를 별도로 설치해야 하는 도구와 달리, AionUi는 설치하는 순간 바로 작동합니다.

• CLI 도구 설치 불필요 — Agent 엔진이 내장되어 있습니다
• 복잡한 설정 불필요 — Google로 로그인하거나 API 키를 붙여넣기만 하면 됩니다
• 완전한 Agent 기능 — 파일 읽기/쓰기, 웹 검색, 이미지 생성, MCP 도구
• 즉시 사용 가능한 어시스턴트 — 내장 20개의 전문 어시스턴트(Cowork, PPT Creator, Word Creator, Excel Creator, Morph PPT 3D, Pitch Deck Creator, Dashboard Creator, Academic Paper Writer, Financial Model Creator 등)가 즉시 사용 가능합니다

멀티 Agent 모드 — 이미 CLI Agent가 있으신가요? 함께 가져오세요

이미 Claude Code, Codex, Hermes Agent 또는 OpenClaw를 사용 중이라면, AionUi가 자동으로 감지하여 모두와 Cowork할 수 있게 해줍니다——내장 Agent와 함께.

지원되는 Agent: 내장 Agent(제로 설정) • Claude Code • Codex • Qwen Code • Goose AI • OpenClaw • Augment Code • CodeBuddy • Kimi CLI • OpenCode • Factory Droid • GitHub Copilot • Qoder CLI • Mistral Vibe • Nanobot • Aion CLI(aionrs, AionUi에 번들된 Rust 기반 백엔드 서비스) • Snow CLI • Kiro • Hermes Agent • Cursor Agent 등

• 자동 감지 — 설치된 CLI 도구를 자동으로 인식
• 통합 인터페이스 — 모든 AI Agent를 관리하는 하나의 Cowork 플랫폼
• 병렬 세션 — 독립적인 컨텍스트로 여러 Agent를 동시에 실행
• MCP 통합 관리 — MCP(Model Context Protocol) 도구를 한 번만 설정하면 모든 Agent에 자동 동기화——각 Agent를 개별적으로 설정할 필요가 없습니다
• YOLO Mode(모든 Agent 작업 자동 승인, 수동 확인 불필요) / 완전 자동 모드 — 원클릭으로 권한 프롬프트 건너뛰기; 모든 Agent가 무인 실행 완전 자동 모드 지원

Team Mode — 정렬된 멀티 에이전트 협업

여러 AI Agent를 조직된 팀으로 실행: Leader Agent가 지시를 받아 서브태스크로 분리하고 내장 Team MCP Server를 통해 Teammate Agent에게 위임. Teammate들은 병렬로 실행하고 비동기 메일박스를 통해 결과를 공유하며 공유 작업 보드에 씁니다.

• 병렬 멀티 에이전트 실행 — Leader가 작업을 서브태스크로 분리하여 병렬 실행하는 Teammate Agent에게 위임; 각 Teammate는 ACP(Agent Communication Protocol, AionUi의 멀티 에이전트 조정 레이어), Gemini 또는 Aionrs를 통해 자체 모델 사용
• Leader 오케스트레이션 — Leader가 할당, 추적, 집계; 지원 백엔드: Claude Code, Codex, Hermes Agent, Gemini, Snow CLI, Aion CLI
• 팀 격리 워크스페이스 — 모든 Agent가 같은 폴더 공유; 각 Agent에 독립적인 권한 확인 다이얼로그가 있으며 사이드바 배지로 승인 대기 표시

• 공유 워크스페이스 — 모든 Agent가 같은 폴더 읽기/쓰기; 파일 패널이 항상 표시
• 지원 백엔드 — Claude Code, Codex, Gemini, Snow CLI, Aion CLI(aionrs); mcpCapabilities.stdio를 가진 다른 ACP 백엔드도 자동 지원
• 동적 스케일링 — 팀 실행 중 Teammate 추가/제거 가능; 응답 없는 Agent는 자동으로 실패 상태로 전환되고 원클릭 제거 지원
• 세밀한 권한 — 각 Agent에 독립적인 권한 확인 다이얼로그; 사이드바 배지로 승인 대기 표시
• 파일 공유 — Leader가 Teammate에게 파일 첨부 전달 가능

모든 API 키로 완전한 Cowork Agent 파워

다른 AI 앱은 API 키가 있는 채팅박스를 제공합니다. AionUi는 완전한 Cowork Agent를 제공합니다.

어떤 모델로 구동하든 Agent의 기능은 동일합니다——파일 읽기/쓰기, 웹 검색, 이미지 생성, 도구 사용. AionUi는 클라우드 서비스와 로컬 배포를 포함한 20+ AI 플랫폼을 지원합니다.

포괄적인 플랫폼 지원:

• 공식 플랫폼 — Gemini, Gemini (Vertex AI), Anthropic (Claude), OpenAI
• 클라우드 제공업체 — AWS Bedrock, New API(통합 AI 모델 게이트웨이)
• 중국 플랫폼 — Dashscope (Qwen), Zhipu, Moonshot (Kimi), Qianfan (Baidu), Hunyuan (Tencent), Lingyi, ModelScope, InfiniAI, Ctyun, StepFun
• 국제 플랫폼 — DeepSeek, MiniMax, OpenRouter, SiliconFlow, xAI, Ark (Volcengine), Poe
• 로컬 모델 — Ollama, LM Studio(로컬 API 엔드포인트가 있는 커스텀 플랫폼을 통해)

AionUi는 NewAPI 게이트웨이 서비스도 지원합니다——다양한 LLM을 집계하고 배포하는 통합 AI 모델 허브입니다. 같은 인터페이스에서 다양한 모델을 유연하게 전환하여 다양한 작업 요구사항을 충족할 수 있습니다.

확장 가능한 어시스턴트 및 스킬

20개의 내장 전문 어시스턴트와 3단계 스킬 시스템을 갖춘 확장 가능한 어시스턴트 시스템. 자신만의 어시스턴트와 스킬을 만들고 관리하세요.

• 커스텀 어시스턴트 만들기 — 커스텀 규칙과 기능을 가진 자신만의 어시스턴트 정의
• 3단계 스킬 — 내장 스킬(AionUi 기본 제공), 커스텀 스킬(사용자 정의), Extension 스킬(서드파티 Extension 제공); 스킬 인디케이터로 대화별 활성화/비활성화
• 대화 수준 제어 — 채팅 헤더의 스킬 인디케이터가 현재 대화의 활성 스킬 표시; 스킬 검색 및 제외 가능

AionUi는 사전 정의된 기능을 가진 20개의 전문 어시스턴트를 포함하며, 커스텀 스킬을 통해 확장 가능합니다:

• 🤝 Cowork — 자율 작업 실행(파일 작업, 문서 처리, 워크플로우 계획)
• 📊 PPT Creator / Morph PPT / Morph PPT 3D — Morph 전환으로 PPTX 프레젠테이션 생성 및 애니메이션
• 📐 Pitch Deck Creator — 투자자용 Pitch Deck 생성
• 📊 Dashboard Creator — 데이터 대시보드 생성
• 📝 Word Creator — 즉시 사용 가능한 Word(.docx) 문서 생성
• 📗 Excel Creator — 분석, 차트, 자동 서식이 포함된 스프레드시트 생성
• 🎓 Academic Paper Writer — 구조화된 학술 논문 작성
• 💰 Financial Model Creator — 재무 모델 및 예측
• ⭐ Star Office Helper — 오피스 생산성 어시스턴트
• 📄 PDF to PPT — PDF를 PPT로 변환
• 🎮 3D 게임 — 단일 파일 3D 게임 생성
• 🎨 UI/UX Pro Max — 전문 UI/UX 디자인(57 스타일, 95 컬러 팔레트)
• 📋 파일로 계획하기 — 복잡한 작업을 위한 파일 기반 계획(Manus 스타일의 지속적인 Markdown 계획)
• 🧭 HUMAN 3.0 코치 — 개인 개발 코치
• 📣 소셜 채용 게시 — 채용 게시 및 발행
• 🦞 moltbook — 제로 배포 AI Agent 소셜 네트워킹
• 📈 Beautiful Mermaid — 플로우차트, 시퀀스 다이어그램 등
• 🔧 OpenClaw 설정 — OpenClaw 통합을 위한 설정 및 구성 어시스턴트
• 📖 스토리 롤플레이 — 캐릭터 카드와 세계 정보를 갖춘 몰입형 스토리 롤플레이(SillyTavern 호환)

커스텀 스킬: skills/ 디렉토리에 스킬을 만들고, 어시스턴트의 스킬을 활성화/비활성화하여 AI 기능을 확장합니다. 스킬은 세 가지 소스에서 제공됩니다: 내장(AionUi 기본 제공), 커스텀(사용자 정의), Extension(Extension SDK를 통해 제공). 내장 스킬에는 pptx, docx, pdf, xlsx, mermaid 등이 포함됩니다.

💡 각 어시스턴트는 markdown 파일로 정의됩니다. assistant/ 디렉토리에서 예제를 확인하세요.

어디서나 Cowork

여러분의 24/7 AI 어시스턴트 — 어떤 기기, 어디서나 AionUi에 접근하세요.

• WebUI 모드 — 스마트폰, 태블릿 또는 어떤 컴퓨터에서든 브라우저를 통해 접근. LAN, 크로스 네트워크 및 서버 배포를 지원. QR 코드 또는 비밀번호 로그인.

• 채팅 플랫폼 통합

  • Telegram — Telegram에서 직접 AI Agent와 Cowork
  • Lark (Feishu) — 기업 협업을 위한 Feishu 봇을 통해 Cowork
  • DingTalk — 자동 폴백이 있는 AI Card 스트리밍
  • WeChat — 위챗 개인 계정 연동
  • WeCom(企业微信) — 팀 협업을 위한 엔터프라이즈 WeChat 봇
  • Slack 등 더 많은 플랫폼이 곧 출시됩니다

설정: AionUi 설정 → WebUI 설정 → Channel, Bot Token을 구성하세요.

원격 인터넷 접근 튜토리얼

✨ Cowork 실연

스케줄 작업 — 자동 조종으로 Cowork

한 번만 설정하면, AI Agent가 스케줄에 따라 자동으로 실행됩니다——진정한 24/7 무인 운영.

• 자연어 — 채팅하듯 Agent에게 무엇을 할지 말하세요
• 세 가지 스케줄링 모드 — 표준 cron 표현식(타임존 지원), 고정 간격(N분/시간마다), 또는 일회성 트리거
• AI가 생성한 작업 — Agent가 대화 중 자율적으로 스케줄 작업 생성 가능
• 사용 사례: 스케줄 데이터 집계, 보고서 생성, 파일 정리, 알림

스케줄링 모드:

• Cron 표현식 — 타임존 지원 표준 5필드 cron(예: 0 9 * * 1, Asia/Shanghai)
• N분/시간마다 — 고정 간격, 예: 30분마다 실행
• 일회성 — 지정된 날짜/시간에 한 번만 트리거, 이후 자동 비활성화

실행 모드:

• 기존 대화 계속 — 바인딩된 대화에 이어서 추가하여 AI가 전체 컨텍스트 기록 유지
• 매번 새 대화 생성 — 트리거마다 새 세션 열기, 독립적인 주기 보고서에 이상적

기타 기능:

• 대화 바인딩 — 각 스케줄 작업은 대화에 바인딩되어 컨텍스트와 기록을 유지합니다
• 자동 실행 — 작업이 스케줄된 시간에 자동으로 실행되어 대화에 메시지를 보냅니다
• 쉬운 관리 — 언제든지 스케줄 작업을 생성, 수정, 활성화/비활성화, 삭제 및 볼 수 있습니다
• 절전 방지 — AionUi가 작업 활성화 중 시스템 절전 자동 방지, 절전 해제 후 누락된 트리거 감지
• 고급 설정 — 각 작업에 고유한 모델, 워크스페이스 디렉토리, 추론 노력 설정 가능

실제 예시:

• 매일 날씨 보고서 생성
• 주간 판매 데이터 집계
• 월간 백업 파일 정리
• 커스텀 알림 알림

미리보기 패널 — AI 생성 결과 즉시 보기

10+ 형식: PDF, Word, Excel, PPT, 코드, Markdown, 이미지, HTML, Diff — 앱을 전환하지 않고 모든 것을 볼 수 있습니다.

• 즉시 미리보기 — Agent가 파일을 생성한 후 앱을 전환하지 않고 즉시 결과를 볼 수 있습니다
• 실시간 추적 + 편집 가능 — 파일 변경을 자동으로 추적; Markdown, 코드, HTML의 라이브 편집 지원
• 멀티 탭 지원 — 여러 파일을 동시에 열고 각각 자체 탭에서
• 버전 기록 — 파일의 이전 버전을 보고 복원(Git 기반)

지원되는 미리보기 형식:

• 문서 — PDF, Word (.doc, .docx, .odt), Excel (.xls, .xlsx, .ods, .csv), PowerPoint (.ppt, .pptx, .odp)
• 코드 — JavaScript, TypeScript, Python, Java, Go, Rust, C/C++, CSS, JSON, XML, YAML, Shell 스크립트 및 30+ 프로그래밍 언어
• 마크업 — Markdown (.md, .markdown), HTML (.html, .htm)
• 이미지 — PNG, JPG, JPEG, GIF, SVG, WebP, BMP, ICO, TIFF, AVIF
• 기타 — Diff 파일 (.diff, .patch)

스마트 파일 관리 — 자동화된 파일 작업

일괄 이름 변경, 자동 정리, 스마트 분류, 파일 병합——Cowork Agent가 여러분을 위해 처리합니다.

• 자동 정리 — 콘텐츠를 지능적으로 식별하고 자동 분류하여 폴더를 깔끔하게 유지
• 효율적인 일괄 처리 — 원클릭 이름 변경, 파일 병합, 지루한 수동 작업에 작별 인사
• 자동화 실행 — AI Agent가 독립적으로 파일 작업을 실행하고, 파일을 읽고 쓰며, 작업을 자동으로 완료합니다

사용 사례:

• 파일 유형별로 지저분한 다운로드 폴더 정리
• 의미 있는 이름으로 사진 일괄 이름 변경
• 여러 문서를 하나로 병합
• 콘텐츠별로 파일 자동 분류

Excel 데이터 처리 — AI 구동 분석

Excel 데이터를 깊이 분석하고, 보고서를 자동으로 아름답게 만들고, 인사이트를 생성합니다——모두 AI Agent가 구동합니다.

• 스마트 분석 — AI가 데이터 패턴을 분석하고 인사이트를 생성합니다
• 자동 포맷팅 — 전문적인 스타일링으로 Excel 보고서를 자동으로 아름답게 만듭니다
• 데이터 변환 — 자연어 명령으로 데이터를 변환, 병합 및 재구성합니다
• 보고서 생성 — 원시 데이터에서 포괄적인 보고서를 만듭니다

사용 사례:

• 판매 데이터를 분석하고 월간 보고서 생성
• 지저분한 Excel 파일 정리 및 포맷팅
• 여러 스프레드시트를 지능적으로 병합
• 데이터 시각화 및 차트 생성

AI 이미지 생성 및 편집

Gemini 구동의 지능형 이미지 생성, 편집 및 인식

• 텍스트-이미지 — 자연어 설명에서 이미지 생성
• 이미지 편집 — 기존 이미지 수정 및 향상
• 이미지 인식 — 이미지 콘텐츠 분석 및 설명
• 일괄 처리 — 한 번에 여러 이미지 생성

이미지 생성 모델 구성 가이드

문서 생성 — PPT, Word, Markdown

AI Agent로 전문 문서를 자동 생성합니다——프레젠테이션, 보고서 등.

• PPTX 생성기 — 개요 또는 주제에서 전문 프레젠테이션 만들기
• Word 문서 — 적절한 구조를 가진 포맷된 Word 문서 생성
• Markdown 파일 — 문서화를 위한 Markdown 문서 생성 및 포맷팅
• PDF 변환 — 다양한 문서 형식 간 변환

사용 사례:

• 분기별 비즈니스 프레젠테이션 생성
• 기술 문서 만들기
• PDF를 편집 가능한 형식으로 변환
• 연구 논문 자동 포맷팅

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

자신만의 CSS 코드로 커스터마이징하여 인터페이스를 선호도에 맞추세요

• ✅ 완전히 커스터마이징 가능 — CSS 코드를 통해 인터페이스 색상, 스타일, 레이아웃을 자유롭게 커스터마이징하여 독점적인 경험을 만드세요

멀티태스크 병렬 처리

여러 대화를 열고, 작업이 섞이지 않으며, 독립적인 메모리, 효율이 두 배

• ✅ 독립적인 컨텍스트 — 각 대화가 자체 컨텍스트와 기록을 유지합니다
• ✅ 병렬 실행 — 간섭 없이 여러 작업을 동시에 실행합니다
• ✅ 스마트 관리 — 시각적 표시기로 대화 간 쉽게 전환

🤔 왜 AionUi를 Claude Cowork보다 선택해야 하나요?

AionUi는 무료 오픈소스 Multi-AI Agent 데스크톱입니다. macOS에서만 실행되고 Claude에 고정된 Claude Cowork과 비교하여, AionUi는 전체 모델, 크로스 플랫폼 강화 버전입니다.

심층 AI 오피스 시나리오 지원:

• 파일 관리: 로컬 폴더를 지능적으로 정리하고 원클릭으로 일괄 이름 변경.
• 데이터 처리: Excel 보고서를 깊이 분석하고 자동으로 아름답게 만듭니다.
• 문서 생성: PPT, Word, Markdown 문서를 자동으로 작성하고 포맷팅합니다.
• 즉시 미리보기: 내장 10+ 형식 미리보기 패널, AI 협업 결과가 즉시 표시됩니다.

빠른 질문과 답변

AionUi 사용 사례 보기

커뮤니티 기사

• 오픈소스 무료 Cowork, 전체 모델 통합 + 자율 파일 작업 — 오픈소스 AI 프로젝트 구현
• 일반인들이 APP처럼 Claude Code를 사용할 수 있게 하기 — 게으른 고양이는 물고기를 좋아함
• 5500 Stars: 오픈소스가 Anthropic의 AI 도구 방어막을 어떻게 깨는가 — AI 실리콘 모멘트

AionUi에 대한 동영상을 만들었나요? X에서 알려주세요, 여기에 소개하겠습니다!

🚀 빠른 시작

시스템 요구사항

• macOS: 10.15 이상
• Windows: Windows 10 이상
• Linux: Ubuntu 18.04+ / Debian 10+ / Fedora 32+
• 메모리: 4GB 이상 권장
• 저장 공간: 500MB 이상 사용 가능한 공간

설치

위 버튼을 클릭하여 Releases 페이지로 이동한 후 플랫폼에 맞는 설치 파일을 다운로드하세요（macOS / Windows / Linux）。

# Alternatively, macOS via Homebrew
brew install aionui

3단계로 시작하기

1. 설치 AionUi
2. 로그인 Google 계정으로 또는 API 키 입력
3. Cowork 시작 — 내장 AI Agent가 준비되었습니다

📖 상세 가이드

🚀 빠른 시작

• 📖 완전한 설치 가이드 — 다운로드부터 구성까지의 상세한 단계
• ⚙️ LLM 구성 가이드 — 멀티 플랫폼 AI 모델 구성
• 🤖 멀티 Agent 모드 설정 — 터미널 AI Agent 통합
• 🔌 MCP 도구 구성 — Model Context Protocol 서버 설정
• 🌐 WebUI 구성 가이드 — 완전한 WebUI 설정 및 구성 튜토리얼

🎯 사용 사례

• 📁 파일 관리 — 스마트 파일 정리
• 📊 Excel 처리 — AI 구동 데이터 처리
• 🎨 이미지 생성 — AI 이미지 생성
• 📚 더 많은 사용 사례

❓ 지원 및 도움말

• ❓ FAQ — 질문 및 문제 해결
• 🔧 구성 및 사용 튜토리얼 — 완전한 구성 문서

💬 커뮤니티 및 지원

여러분의 아이디어가 중요합니다! 모든 제안과 피드백을 소중히 여깁니다.

• GitHub Discussions — 아이디어를 공유하고 팁을 교환하세요
• 문제 보고 — 버그 및 기능 요청
• 릴리스 업데이트 — 최신 버전 받기
• Discord 커뮤니티 — 영어 커뮤니티
• WeChat 그룹 — 중국어 커뮤니티

기여하기

PR을 열기 전에 CONTRIBUTING.md를 읽어주세요.

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

개발 환경 설정

기술 스택: Electron · Vite · React · Bun

bun install        # 의존성 설치
bun run dev        # 개발 서버 시작
bun run test       # 단위 테스트 실행

라이선스

이 프로젝트는 Apache-2.0 라이선스 하에 라이선스됩니다.

기여자

Star 히스토리

마음에 드시면 스타를 눌러주세요

버그 보고 · 기능 요청