Skip to content

README.ko.md

Latest commit

 

History

History
313 lines (211 loc) · 10.8 KB

README.ko.md

File metadata and controls

313 lines (211 loc) · 10.8 KB

English | 中文 | 日本語 | 한국어 | Русский | Español | Türkçe | العربية | Bahasa Indonesia | தமிழ் | हिन्दी

Anastomotic™ - 오픈소스 AI 데스크톱 에이전트

Anastomotic는 로컬 머신에서 파일 관리, 문서 작성, 브라우저 작업을 자동화하는 오픈소스 AI 데스크톱 에이전트입니다. 자체 API 키(OpenAI, Anthropic, Google, xAI)를 사용하거나 Ollama를 통해 로컬 모델을 실행하세요.

로컬 머신에서 실행. 자체 API 키 또는 로컬 모델 사용. MIT 라이선스.

Mac용 다운로드 (Apple Silicon) · Mac용 다운로드 (Intel) · Windows 11용 다운로드 · Linux (ARM64) 다운로드 · Linux (x64) 다운로드 · Linux (.deb x64) 다운로드 · Anastomotic 웹사이트 · Anastomotic 블로그 · Anastomotic 릴리스



무엇이 다른가

🖥️ 로컬에서 실행

  • 파일은 내 머신에 저장
  • 접근 가능한 폴더를 직접 결정
  • Anastomotic(또는 누구에게도)에 데이터가 전송되지 않음

🔑 자체 AI 사용

  • 자체 API 키 사용 (OpenAI, Anthropic 등)
  • 또는 Ollama로 실행 (API 키 불필요)
  • 구독 없음, 업셀 없음
  • 서비스가 아닌 도구

📖 오픈소스

  • 모든 코드가 GitHub에 공개
  • MIT 라이선스
  • 수정, 포크, 변경, 수정 자유

⚡ 채팅만이 아닌 실행

  • 파일 관리
  • 문서 작성
  • 커스텀 자동화
  • 스킬 학습


실제 기능
📁 파일 관리 ✍️ 문서 작성 🔗 도구 연결
콘텐츠나 규칙에 따라 파일 정리, 이름 변경, 이동 문서 작성, 요약, 재작성 지시 Notion, Google Drive, Dropbox 등과 연동 (로컬 API 통해)
⚙️ 커스텀 스킬 🛡️ 완전한 제어
반복 워크플로우를 정의하고 스킬로 저장 모든 작업을 승인. 로그 확인 가능. 언제든 중지 가능.

사용 사례

  • 프로젝트, 파일 유형, 날짜별로 폴더 정리
  • 문서, 보고서, 회의록 작성, 요약, 재작성
  • 리서치 및 양식 작성 등 브라우저 워크플로우 자동화
  • 파일과 노트에서 주간 업데이트 생성
  • 문서와 캘린더에서 회의 자료 준비

지원 모델 및 제공업체

  • Anthropic (Claude)
  • OpenAI (GPT)
  • Google AI (Gemini)
  • xAI (Grok)
  • DeepSeek
  • Moonshot AI (Kimi)
  • Z.AI (GLM)
  • MiniMax
  • Venice.ai
  • Amazon Bedrock
  • Azure Foundry
  • OpenRouter
  • LiteLLM
  • Ollama (로컬 모델)
  • LM Studio (로컬 모델)

프라이버시 및 로컬 우선

Anastomotic는 로컬 머신에서 실행됩니다. 파일은 기기에 저장되며, 접근 가능한 폴더를 선택할 수 있습니다.


시스템 요구 사항

  • macOS (Apple Silicon)
  • Windows 11
  • Ubuntu (ARM64)
  • Ubuntu (x64)


사용 방법

설정은 2분이면 완료.

단계 작업 세부사항
1 앱 설치 DMG 다운로드 후 응용 프로그램 폴더로 드래그
2 AI 연결 Google, OpenAI, Anthropic (또는 기타) API 키 사용 또는 ChatGPT (Plus/Pro)로 로그인. 구독 없음.
3 접근 권한 부여 접근 가능한 폴더 선택. 사용자가 제어.
4 작업 시작 문서 요약, 폴더 정리, 보고서 생성 요청. 모든 작업 승인.





자주 묻는 질문

Anastomotic는 로컬에서 실행되나요? 네. Anastomotic는 로컬 머신에서 실행되며, 접근 가능한 폴더를 제어할 수 있습니다.

API 키가 필요한가요? 자체 API 키 (OpenAI, Anthropic, Google, xAI 등)를 사용하거나 Ollama를 통해 로컬 모델을 실행할 수 있습니다.

Anastomotic는 무료인가요? 네. Anastomotic는 오픈소스이며 MIT 라이선스입니다.

어떤 플랫폼을 지원하나요? macOS (Apple Silicon)와 Windows 11이 현재 사용 가능합니다. Ubuntu (ARM64) 및 Ubuntu (x64)도 지원됩니다。



개발

pnpm install
pnpm dev

끝입니다.

사전 요구 사항
  • Node.js 20+
  • pnpm 9+
모든 명령어
명령어 설명
pnpm dev 개발 모드로 데스크톱 앱 실행
pnpm dev:clean 클린 스타트로 개발 모드
pnpm build 모든 워크스페이스 빌드
pnpm build:desktop 데스크톱 앱만 빌드
pnpm -F @anastomotic/desktop package:win Windows 설치 프로그램 빌드 (x64)
pnpm -F @anastomotic/desktop package:linux Linux 아티팩트 빌드 (AppImage + deb)
pnpm lint TypeScript 검사
pnpm typecheck 타입 검증
pnpm -F @anastomotic/desktop test:e2e Playwright E2E 테스트
환경 변수
변수 설명
CLEAN_START=1 앱 시작 시 모든 저장 데이터 삭제
E2E_SKIP_AUTH=1 온보딩 플로우 건너뛰기 (테스트용)
아키텍처 
apps/
  desktop/        # Electron 앱 (main + preload + renderer)
packages/
  shared/         # 공유 TypeScript 타입

데스크톱 앱은 Vite로 번들링된 React UI와 함께 Electron을 사용합니다. 메인 프로세스는 node-pty를 사용하여 OpenCode CLI를 생성하여 작업을 실행합니다. API 키는 OS 키체인에 안전하게 저장됩니다.

자세한 아키텍처 문서는 CLAUDE.md를 참조하세요.



기여

기여를 환영합니다! PR을 자유롭게 열어주세요.

# Fork → Clone → Branch → Commit → Push → PR
git checkout -b feature/amazing-feature
git commit -m 'Add amazing feature'
git push origin feature/amazing-feature


Anastomotic 웹사이트 · Anastomotic 블로그 · Anastomotic 릴리스 · Issues · Twitter


MIT 라이선스 · Anastomotic 제작


키워드: AI 에이전트, AI 데스크톱 에이전트, 데스크톱 자동화, 파일 관리, 문서 작성, 브라우저 자동화, 로컬 우선, macOS, 프라이버시 우선, 오픈소스, Electron, 컴퓨터 사용, AI 어시스턴트, 워크플로우 자동화, OpenAI, Anthropic, Google, xAI, Claude, GPT-4, Ollama