qqqqqf-q/Arkloop

干净、强大、属于你的 AI Agent 平台 --AI agents, without the clutter.

Arkloop – 로컬 우선 AI 에이전트 플랫폼

무엇인가요 – Arkloop는 사용자의 컴퓨터에서 완전히 실행되는 오픈소스 데스크톱 애플리케이션입니다. Go 기반 백엔드, React 웹 UI, Electron 쉘을 통합하여 외부 서버 없이도 풀기능 채팅 인터페이스, 다중 모델 라우팅, 도구 호출, 지속적 메모리를 제공합니다.

왜 중요한가요 – 대부분의 AI 채팅 도구는 클라우드 서비스에 의존하거나 별도의 백엔드 구성(데이터베이스, 메시지 큐 등)이 필요합니다. Arkloop는 로컬 SQLite 저장소를 사용해 모든 것을 하나의 내장 프로세스로 통합하여, 개인정보 보호, 오프라인 사용 가능, macOS, Linux, Windows에서 간편한 설치 경험을 제공합니다.

핵심 기능

기능	제공되는 기능
다중 모델 라우팅	OpenAI, Anthropic, Gemini 또는 어떤 OpenAI 호환 API에도 연결 가능. 모델 우선순위를 설정하고, 사용자 고유의 API 키를 제공할 수 있습니다.
에이전트 런타임	내장된 도구 호출, MCP 서버, "ClawHub" 스킬 지원. 하위 에이전트 생성 및 작업 스케줄링 가능.
메모리	기본적으로 텍스트 노트북 제공; 선택적으로 세마틱 메모리(Nowledge) 사용 가능. 상태 없는 봇으로 비활성화도 가능.
채널	동일한 에이전트를 Telegram, Discord, QQ, Feishu, WeChat 봇으로 내보낼 수 있으며, 스케줄된 허트비트 실행 지원.
사용자 정의 페르소나	각 페르소나별로 별도의 시스템 프롬프트, 도구 허용 목록, 예산 제한, 실행 타입 설정 가능.

시작하기

데스크톱 앱 – GitHub 릴리스 페이지에서 OS용 최신 릴리스를 다운로드. 설치 프로그램에는 런타임이 포함되어 있으며, 앱을 실행하기만 하면 됩니다.
CLI – 최초 데스크톱 실행 후 ark 명령줄 도구를 설치할 수 있습니다. ark web를 실행하면 동일한 로컬 서버를 헤드리스로 시작합니다.
패키지 매니저 – macOS: brew install qqqqqf-q/arkloop/arkloop, Arch Linux: yay -S arkloop-bin / arkloop-git.
헤드리스 Linux용 원라인 – curl-pipe 명령어로 적절한 바이너리를 가져와 0.0.0.0에서 웹 UI를 시작합니다.

아키텍처 개요

구성 요소	기술 스택	역할
데스크톱	Electron	Go 런타임을 내장하고 UI를 제공하는 네이티브 쉘.
런타임	Go	API, 워커 로직, SQLite 저장소, 인프로세스 이벤트 버스를 제공하는 단일 프로세스.
웹 UI	React + TypeScript	채팅 인터페이스; 데스크톱 앱에 번들링되며 `ark web`에서도 제공됨.
CLI	Go	`ark` 실행 파일 – 동일한 런타임에 대한 헤드리스 진입점.

모든 데이터는 로컬 SQLite 데이터베이스에 저장되며, Postgres, Redis, 메시지 큐와 같은 외부 서비스는 필요 없습니다.

개발 및 기여

프론트엔드 – pnpm install 후 src/apps/desktop 내에서 pnpm dev를 실행하면 Electron 앱의 핫리로드 가능.
헤드리스 모드 – pnpm build로 웹 UI를 빌드하고 Go 진입점 실행: go run ./src/services/cli/cmd/ark web.
CI – bin/ci-local quick로 로컬 지속적 통합 검사 실행.
기여는 환영합니다. 코드 외 피드백도 GitHub 이슈를 통해 기대합니다.

라이선스

Arkloop는 Apache 2.0을 수정한 커스텀 "Arkloop 라이선스"를 사용하며, 다음 조항이 추가되어 있습니다:

다중 테넌트 제한 – 허가 없이 다중 테넌트 SaaS로 코드를 사용할 수 없습니다.

커뮤니티 및 지원

Telegram 그룹 – https://t.me/Arkloop_io
보안 – SECURITY.md에 따라 이메일(qingf622@outlook.com)로 취약점 신고.
스폰서 – 개인 후원자는 README에 목록으로 안내되어 있습니다.

결론 – Arkloop는 개발자와 고급 사용자가 AI 에이전트를 실험하고, 여러 LLM 제공업체를 시도하며, 인기 있는 메시징 플랫폼에 봇을 노출할 수 있는 깔끔하고 자가 완결형 환경을 제공합니다. 노트북에서 모든 작업을 완료할 수 있습니다.