SmartiAI Agent for Windows

SmartiAI Agent for Windows는 Windows 컴퓨터에서 실용적인 작업을 수행할 수 있는 로컬 우선형 데스크톱 AI 에이전트입니다. 이 에이전트는 히브리어 RTL 채팅 인터페이스, 구성 가능한 모델 제공자(model providers), 로컬 메모리, 파일 및 웹 도구, 브라우저 및 데스크톱 자동화, 이메일 처리, 백그라운드 작업, 알림, 사용자 지정 도구, MCP 패키지, 그리고 Skills를 결합합니다.

Smarti는 사용자가 제어권을 유지하면서 컴퓨터를 작동하도록 돕기 위해 설계되었습니다. 민감한 동작은 표시되고, 구성 가능하며, 실행 전에 승인이 필요할 수 있습니다.

현재 출시 목표: V0.87.0

.

UI/UX 개발은 현재 프리미엄 Tauri 리디자인 계획과 스테이지 원장(stage ledger) / 핸드오프를 따르고 있습니다. 이 계획은 기능, 데이터 및 런타임 계약을 유지하면서 정확한 PyQt 시각적 복제를 대체합니다. 준비는 완료되었지만, 새로운 인터페이스는 아직 구현되거나 출시되지 않았습니다.

• 계획 수립(planning), 단계별 진행 상황, 도구 피드백, 재시도(retries) 및 최종 검증을 통한 에이전트 작업 실행.
• 로컬 파일 작업: 파일 및 폴더 열기, 텍스트 파일 작성, 문서 읽기, 이름 및 내용 검색, 이미지 분석, OCR 텍스트 추출, 활성 모델 컨텍스트에 파일 첨부, 그리고 파일을 휴지통(Recycle Bin)으로 이동.
• 웹 도구: 인터넷 검색, 웹페이지 읽기, 브라우저 열기, 날씨 조회, 그리고 정중한 크롤링 제어(polite crawl controls)를 사용한 웹사이트 스크래핑.
• 화면 컨텍스트: 스크린샷 캡처, 스크린샷 저장, 로컬 이미지 분석.
• Windows 제어: 설치된 애플리케이션 검색, 소프트웨어 실행, UI 요소 검사, 버튼 호출(invoke), 텍스트 필드 설정, 키/단축키 전송, 클립보드 사용, 오디오 음소거 상태 관리.
• 중앙 채팅, 접을 수 있는 대화 사이드바, 그리고 비어 있다가 반복적인 파일, 브라우저 또는 터미널 탭과 컨텍스트 생성 캔버스/아티팩트 탭이 열리는 동적 왼쪽 작업 영역을 갖춘 통합 Smarti Workspace.
• Playwright/CDP를 통한 Smarti Browser의 영구 임베디드 프로필에 대한 브라우저 자동화, 페이지 상태 추출 및 양식/탐색 도우미 기능.

사용자가 시작하는 일회성 가져오기(import)를 통해 로컬 Chromium 기반 프로필의 호환 가능한 쿠키, 기록 및 북마크를 복사할 수 있습니다. 비밀번호는 가져오지 않습니다.

• IMAP/SMTP를 통한 이메일: 검색, 읽기, 초안 작성, 보내기, 답장, 전달, 보관, 휴지통/삭제, 이동/복사, 폴더 관리, 플래그 지정, 스타일이 적용된 RTL/HTML 메시지 및 첨부 파일 처리.
• 백그라운드 작업: 일회성 및 반복 작업, 알림 설정, 재시도/취소/편집 흐름, Windows 토스트 알림, 캘린더 이벤트 파일 생성.
• 사용자, 단기, 장기, 도구 메모리 버킷을 포함하는 로컬 메모리 기능으로, 만료(expiry) 처리 및 Markdown 내보내기 기능을 지원합니다.
• 맞춤형 Python 도구, MCP 패키지, 그리고 제어된 설치/실행 권한을 가진 Skills를 통한 확장성 제공.
• 사용량 추적, 개발자 로그, 런타임 트레이스, 감사 로그(audit logs), 그리고 litellm을 통한 선택적 비용 견적 기능.

• "다운로드 폴더에서 가장 최신 인보이스 PDF를 찾아 요약하고, 그 요약을 저장해 줘."
• "이 리포지토리에서 데스크톱 자동화 구현체를 검색하고 흐름을 설명해 줘."
• "브라우저를 열고 이 양식을 작성한 후 제출하고, 무슨 일이 일어났는지 알려줘."
• "읽지 않은 고객 이메일을 확인하고, 전문적인 답장을 초안 작성하여 검토를 위해 남겨줘."
• "스크린샷을 찍고 화면에 보이는 것을 설명해 줘."
• "내일 아침에 이 릴리스 작업을 계속하도록 알림 설정해 줘."
• "이 파일 처리 워크플로우를 위한 재사용 가능한 Python 도구를 만들어 줘."
• "현재 웹 검색 결과를 검색하고, 가장 좋은 출처를 읽어 링크와 함께 요약해 줘."
• "내가 이 프로젝트에 간결한 히브리어 답변을 선호한다는 것을 기억해 줘."

Smarti는 설정 화면에서 여러 제공업체를 지원합니다:

• Google Gemini
• OpenAI
• OpenAI Codex Sign-in (ChatGPT 계정, 공식 Codex CLI를 통해)
• Anthropic
• OpenRouter
• Groq
• NVIDIA NIM
• Cerebras
• Hugging Face
• DeepSeek
• Alibaba Qwen / DashScope
• Zhipu GLM
• Moonshot Kimi
• Mistral AI
• Together AI
• Perplexity
• xAI
• LM Studio와 같은 로컬 OpenAI 호환 서버

API 키는 Keyring 또는 Windows DPAPI를 통해 저장할 수 있습니다. 로컬 OpenAI 호환 서버는 클라우드 API 키 없이 구성할 수 있습니다.

Codex 제공업체는 공식 model/list API를 통해 사용 가능한 텍스트 모델을 검색하며, 여기에는 로그인된 계정에 노출되는 향후 모델도 포함됩니다. 현재 카탈로그를 사용하려면 Codex CLI 0.159.0 이상 버전을 설치하고 ChatGPT로 로그인해야 합니다. CLI가 누락되거나, 오래되었거나, 연결이 끊겼거나, 검색에 실패하는 경우, Smarti는 gpt-6.1-sol, gpt-6-sol, gpt-6-luna를 포함한 대체 목록을 유지하며 연결 또는 업데이트 메시지를 표시합니다. 모델 액세스는 사용자 계정 및 플랜의 적용을 받으며, 스마트티에 자격 증명은 번들로 제공되지 않습니다.

Smarti는 맹목적인 자동화보다는 명시적인 제어(explicit control)를 중심으로 구축되었습니다. 민감한 기능들은 설정, 정책 확인(policy checks), 승인 프롬프트(approval prompts)에 의해 관리됩니다. 도구 그룹을 활성화하거나 비활성화하고, 자율성 수준을 선택하며, 셸 명령어 및 확장 설치에 대한 승인을 요구하고, 샌드박스 루트를 구성하고, 로그를 편집하며, 클라우드 업로드 동작을 제어할 수 있습니다.

파일 작성, 명령어 실행, 데스크톱 제어, 이메일 읽기 또는 보내기, 스크린샷 사용, 외부 도구 설치, 또는 로컬 콘텐츠를 클라우드 모델에 업로드하는 등의 작업은 민감한 것으로 간주되어 사용자 승인이 필요할 수 있습니다.

소스 실행 요구 사항: Windows, Python 3.10 이상, Git 도구를 사용하려면 Git이 필요합니다.

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
...

콘솔 창 없이 실행하려면:

pythonw smarti_core.pyw

• Windows 환경에서 Smarti Browser는 설치된 Edge, Chrome 또는 호환 Chromium 엔진을 앱 내부에 직접 임베드하고 Playwright/CDP와 영구 프로필을 공유합니다.
  PyQt6-WebEngine은 주(primary) Windows 브라우저라기보다는 호환성 렌더러로 남아 있습니다. - 소스에서 실행할 때 MCP 지원에는 Node.js와 npx가 필요합니다. 패키징된 릴리스에는 사설 Node.js 런타임이 포함되어 있습니다. - 음성 입력은 작동하는 마이크, SpeechRecognition, keyboard, 그리고 PyAudio를 필요로 합니다. - OCR(광학 문자 인식)을 위해서는 pytesseract, Pillow, 그리고 PATH에서 사용 가능한 시스템 Tesseract OCR 설치가 필요합니다. - 사용 비용 추정치는 litellm이 설치되었을 때 더 풍부해집니다. - 라이브 비주얼 캔버스(Live Visual Canvas)는 실험적이며 기본적으로 꺼져 있습니다. 설정을 통해 Settings → Tools & Communication → Advanced에서 קנבס חזותי מתקדם을 활성화하세요. Windows에서는 임시 임베디드 Chromium 호스트와 토큰화된 루프백 브리지를 사용합니다. 네트워크, 외부 파일, 다운로드, 팝업 및 미디어 권한은 기본적으로 차단됩니다. 별도의 אפשר תמונות HTTPS מהרשת בתוך קנבס 설정은 HTTPS 이미지 리소스만 허용하며, 탐색(navigation)과 다른 모든 외부 요청은 계속 차단됩니다. - 패키징된 릴리스에는 사용자 지정 Python 도구, MCP 지원 및 Skill 종속성 설치에 사용되는 사설 Python 런타임이 포함되어 있습니다.

현재 Tauri 진입점은 재사용 가능하며 격리된 소스 스냅샷을 빌드합니다:

pwsh -NoProfile -File .\scripts\build_and_package.ps1
pwsh -NoProfile -File .\\scripts\\build_and_package.ps1 -Version 0.88.0 -Label preview

이는 스냅샷에서 요청된 버전만 동기화하고, Qt가 없는 Core/Tauri GUI 및 사설 런타임을 빌드하며, NSIS/휴대용 ZIP 아티팩트를 생성하고, 패키징된 감독자(supervisor)/브라우저 검사를 실행하며, release 아래 새 폴더에 해시/소스 출처를 기록합니다. 이전 빌드와 작동하는 소스는 보존됩니다.
로컬 서명되지 않은 아티팩트가 기본이며, 서명된 업데이트 프로그램 및 오프라인 WebView2 설치 옵션은 명시적입니다. 빌드 옵션을 참조하세요.
scripts/build_release.ps1는 역사적인 PyQt 레시피입니다.

UI 변경 사항은 승인된 디자인 계획과 공유된 desktop/src/design-system components를 따릅니다. 이는 의도적인 기본값이며, 요청된 변경 사항은 중앙에서 업데이트할 수 있습니다. 현재 상태 및 수용 범위는 UX 실행 원장(ledger)에 있습니다.

Smarti는 GitHub Releases를 확인하고, 최신 릴리스 태그와 APP_VERSION을 비교하여 현재 설치 유형에 맞는 올바른 Windows 에셋을 다운로드합니다.

V0.87.0의 경우, V0.87.0 또는 0.87.0으로 태그가 지정된 GitHub 릴리스를 게시하고 다음 파일을 첨부해야 합니다:

SmartiAI-Agent-for-Windows-0.87.0-Setup.exe
SmartiAI-Agent-for-Windows-0.87.0-win-x64-portable.zip

설치된 복사본은 setup EXE를 선호하고, 휴대용(Portable) 복사본은 portable ZIP을 선호합니다. GitHub가 릴리스 에셋 다이제스트(digest)를 제공하면, Smarti는 이를 SHA-256 검증에 사용합니다.

smarti_core.pyw 소스 실행기 및 메인 진입점
smarti/ 모듈형 애플리케이션 코드
app.py 시작, 스플래시 화면, 법적 게이트(legal gate), 및 메인 창 설정
...

Windows에서는 새 설치 시 런타임 데이터가 기본적으로 %APPDATA%\SmartiAI에 저장됩니다. 생성된 출력 파일은 Documents 폴더가 존재하는 경우 Documents\Smarti_Outputs로 이동합니다. 레거시 프로젝트 루트의 런타임 파일은 첫 실행 시 복사되어 제자리에 남겨집니다.

일반적인 로컬 파일에는 설정, 사용 데이터, 메모리, 채팅 기록, 로그, 사용자 지정 도구(custom tools), MCP 도구, Skills, 브라우저 세션 데이터, 및 첨부 파일 캐시 데이터가 포함됩니다. 민감하고 생성된 경로는 Git에서 제외됩니다.

Smarti는 새 버전부터 MIT 라이선스 하에 배포되지 않습니다.

버전 V0.69.0부터 Smarti는 다음의 라이선스를 따릅니다:

PolyForm Noncommercial License 1.0.0

이는 다음과 같은 의미입니다:

• Smarti는 개인적, 교육적, 연구용, 실험적, 취미 또는 기타 비상업적 목적으로 사용될 수 있습니다.
• 저작권자로부터 별도의 서면 상업 라이선스를 받지 않고는 어떤 상업적인 목적을 위해서도 Smarti를 사용할 수 없습니다.
• 상업적 사용에는 회사, 사업체, 스타트업, 계약자, 컨설턴트, 서비스 제공업체, 유료 제품, SaaS 서비스, 상업적 제품 통합, 내부 비즈니스 사용, 재판매, 상업적 배포, 리패키징, 화이트 라벨링 또는 수익 창출이나 상업적 이점을 목적으로 하는 모든 사용이 포함됩니다.
• Smarti를 상업적으로 사용하려는 사람은 사전에 서면 승인과 별도의 상업 라이선스를 받아야 합니다.

이전에 MIT 라이선스 하에 발표되었던 Smarti의 이전 버전들은 해당 특정 버전에 한해서만 MIT 라이선스 하에 계속 이용 가능합니다. 이 라이선스 변경은 이 변경 이후에 발표되는 새로운 버전에만 적용됩니다.

본 소프트웨어는 어떠한 종류의 보증 없이 '있는 그대로(as is)' 제공됩니다. Smarti 사용은 전적으로 사용자 본인의 위험 부담입니다. 저작권자는 소프트웨어를 설치, 사용, 수정, 배포, 통합 또는 운영함으로써 발생하는 모든 손해, 데이터 손실, 파일 삭제, 오작동, 개인 정보 문제, 보안 사고, 재정적 손실, 법률 위반, AI 모델의 부정확한 조치, 도구의 부정확한 조치, 명령, 스크립트, 플러그인, Skill, 통합, 타사 서비스 또는 기타 모든 피해에 대해 책임이나 배상 책임을 지지 않습니다.

Smarti는 자율적 행동, 컴퓨터 제어, 명령어 실행, 파일 접근, 네트워크 접근, 타사 도구, 인공지능 모델 및 민감한 작업의 자동화를 포함하거나 활성화할 수 있습니다. 사용자는 소프트웨어의 동작을 검토하고, 감독하며, 권한을 제한하고, 백업을 생성하며, 적절한 경우 샌드박스 또는 테스트 환경을 사용하는 것에 대한 책임이 있습니다.

전체 라이선스 약관은 LICENSE 파일에서 확인하십시오.

인터페이스 작업: 새로운 디자인 계획 및 실행 일정과 대화 지침. 이 계획은 PyQt의 시각적 복사본을 대체하며 기능과 데이터를 유지합니다. 문서는 준비되었고, 새 인터페이스는 아직 구현되지 않았습니다.

SmartiAI Agent for Windows는 Windows 컴퓨터에서 실질적인 업무를 수행하는 데 사용되는 AI 에이전트입니다. 이 에이전트는 오른쪽에서 왼쪽으로 작동하는 히브리어 채팅 인터페이스, 설정 가능한 모델 공급자, 로컬 메모리, 파일 및 네트워크 도구, 브라우저 및 데스크톱 자동화, 이메일 관리, 백그라운드 작업, 알림, 맞춤형 도구, MCP 패키지 및 Skills를 결합합니다.

Smarti는 사용자가 완전한 제어권을 유지하면서 컴퓨터 작업을 수행하는 것을 돕기 위해 설계되었습니다. 민감한 동작은 투명하게 표시되며, 설정 가능하고 실행 전에 승인이 필요할 수 있습니다.

현재 버전 목표: V0.87.0