Apeireth/Apeireth

Apeireth — a digital companion that grows with you. Pure Safe Rust AGI cognitive microkernel: memory that fades like a person's, human approval before every side effect, honest boundaries. 31-member workspace (30 crates + 1 bench).

Apeireth란 무엇인가

Apeireth는 안전한 Rust로 작성된 프라이버시 우선, 데스크톱 기반 AI 컴패니언입니다. 사용자의 기기(Windows, Linux 및 macOS)에서 완전히 실행되며 사용자에 대한 사실을 기억하고, 사용자가 허용할 때만 작동하며, 명시적 승인 없이는 되돌릴 수 없는 작업을 절대 수행하지 않도록 설계되었습니다. 이 프로젝트는 함께 규칙 엔진 기반의 "케어" 시스템, 5계층 하이브리드 메모리 저장소, 그리고 "승인 1회 → 부작용 1회"를 강제하는 엄격한 거버넌스 계층을 구현하는 크레이트 모음(foundation, engine, capabilities, adapters)으로 구성됩니다.

핵심 기능(문서화된 대로)

기능	작동 방식(높은 수준)	현재 상태
메모리	추가 전용, 해시 체인으로 연결된 사실 스트림(이벤트 시간 + 기록 시간의 두 타임스탬프 포함). 검색은 어휘, 의미, 최신성 활성화 계층을 결합합니다. 오래된 사실은 보호로 표시되지 않는 한 "메모리 곡선"에 따라 감쇠합니다.	구현됨 – 기본적으로 켜짐
감정 및 케어	`APEIRETH_ENABLE_CARE`를 통해 활성화할 수 있는 "케어 전위장". 활성화되면 규칙 엔진이 언제 말할지, 얼마나 침묵을 유지할지, 어떤 제스처를 제공할지 결정합니다. 음성 출력은 감정 판독값이 있는 경우에만 톤이 변조됩니다.	구현됨 – 기본적으로 꺼짐
작업 및 신뢰	쓰기 전 읽기 가드, 샌드박스 에스컬레이션 사다리, 2계층 원자적 쓰기 모델을 갖춘 5단계 실행 파이프라인. 작업은 위험 등급으로 분류됩니다. 등급 1(되돌릴 수 없는) 작업에는 인간 승인 "승인 카드"가 필요합니다.	구현됨
다중 가구 클러스터링	각 가구에는 자체 `users/<id>/` 도메인(메모리, 할당량, 원장)이 분리된 데이터 플레인이 있습니다. 도메인 간 읽기/쓰기는 거부됩니다. 파트너 인스턴스는 별도 런타임으로 실행되므로 가구 간에 개성이 이동하지 않습니다.	구현됨
공급자 어댑터	세 가지 라이브 LLM 백엔드(OpenAI 호환, MiniMax, Anthropic)를 지원합니다. Gemini 및 OpenAI-Responses는 프로토콜 정규화기에 불과하며 아직 공급자로 연결되지 않았습니다.	구현됨
SDK / CLI / Tauri UI	CLI(`apeireth-cli`), Tauri 기반 데스크톱 컴패니언, 터미널 UI(`apeireth-tui`). SDK의 WebSocket 전송은 현재 스텁입니다. HTTP 서버는 WS 엔드포인트를 노출하지 않습니다.	UI와 CLI는 작동하고 SDK WS는 스텁입니다

아키텍처 한눈에 보기

+--------------------------------------------------------------+
|  Faces:  companion-desktop (Tauri) • apeireth-tui • CLI      |
+--------------------------------------------------------------+
|  Adapters: gateway (HTTP/SSE, token gate) • SDK • CLI • TUI |
+--------------------------------------------------------------+
|  Assembly: runtime-assembly (production.rs defaults, quota, |
|            approvals)                                        |
+--------------------------------------------------------------+
|  Engine: memory • provider • organ • runtime                |
+--------------------------------------------------------------+
|  Foundation: core (onion/user_domain) • protocol •          |
|            credentials • governance                         |
+--------------------------------------------------------------+

Foundation – 순수 Safe-Rust 핵심 크레이트로, unsafe 코드가 없습니다. 사용자 도메인 격리, 자격 증명 저장(가능한 경우 OS 키링, 그렇지 않으면 평문 폴백), 이중 양파 권한 모델을 처리합니다.
Engine – 메모리 스트림, LLM 공급자 통합, 엄격한 승인 검사 하에 부작용(파일 쓰기, git 쓰기 등)을 수행하는 "organ" 모듈을 구현합니다.
Adapters – 외부 클라이언트를 위한 HTTP/SSE 게이트웨이와 (현재 스텁인) WebSocket SDK를 노출합니다.
Faces – 사용자 대면 애플리케이션: 애니메이션 UI가 있는 Tauri 데스크톱 창, 터미널 UI, 명령줄 클라이언트.

시작하기(사용자 관점)

설치 – Releases 페이지에서 Windows 설치 프로그램을 다운로드(SHA-256 검증)하거나 소스에서 빌드(cargo build --release -p apeireth-cli 및 Tauri UI용 pnpm 빌드).
실행 – 데스크톱 아이콘을 실행하고 LLM 공급자를 선택한 다음 API 키를 입력합니다. 키는 가능한 경우 OS 키링에 저장되고, 그렇지 않으면 환경 변수 또는 메모리 내 저장소로 폴백됩니다.
상호 작용 – 말하거나 입력하면 Apeireth가 메모리에서 가져온 사용자 자신의 단어로 응답합니다. 설정에서 성격 슬라이더를 조정하면 각 변경 사항이 메모리 원장에 기록됩니다.
검증 – README는 해시 체인 무결성, 승인 상태 머신, 예산 게이트 적용을 확인하는 세 가지 CLI 명령으로 구성된 "5분 독립 검증"을 안내합니다.

안전 및 신뢰 메커니즘("신뢰하되 검증하라" 섹션)

Zero-unsafe Rust – 전체 작업 공간은 unsafe를 금지하여 정의되지 않은 동작을 제거합니다.
해시 체인 추가 전용 메모리 – 모든 사실은 이전 사실과 연결되어 변조를 감지할 수 있습니다.
예산 게이트 – 토큰, 도구 단계, 마이크로 비용의 세 가지 차원이 세션별로 추적됩니다. 한도 초과 시 작업이 중단되어 조용히 제한되지 않습니다.
승인 카드 – 되돌릴 수 없는 작업(파일 삭제, 송금, 규칙 변경)은 일회성 인간 승인이 필요합니다. 시스템은 승인을 기록하고 정확히 하나의 부작용을 보장합니다.
정직한 경계 – README는 정의되었지만 연결되지 않은 모든 기능(예: WebSocket 서버, P2P 메시, onion DSL 계층)을 나열합니다. 이러한 기능은 의도적으로 비활성화되고 명확하게 표시되어 사용자가 사용할 수 없는 것을 알 수 있습니다.
내보낼 수 있는 데이터 – 메모리, 원장, 스킬은 패키징, 검증 및 다른 기기로 이동할 수 있습니다. 자격 증명은 내보내기에 포함되지 않습니다.

아직 연결되지 않은 것(정직한 격차)

격차	설명
WebSocket 8프레임 전이중	프로토콜 정의됨, 그러나 `/v1/ws` HTTP 라우트 없음.
P2P 메시	평문 메시만, Noise 핸드셰이크, onion 라우팅 없음.
SDK 전송	스텁 구현(`unimplemented!()`).
3계층 DSL onion	코드는 존재하지만 `APEIRETH_ENABLE_ONION_LAYER=1`이 아니면 비활성화됨.
백업 내보내기	기능은 존재하지만 기본적으로 꺼짐(`APEIRETH_ENABLE_BACKUP_EXPORT=1`).

누가 유용하게 사용할 수 있을까?

프라이버시에 민감한 사용자 – 개인 데이터를 기기 밖으로 전송하지 않는 AI 비서를 원하는 사용자.
개발자 – 명시적 거버넌스가 있는 Rust 우선, 공식적으로 검사된 AI 에이전트 프레임워크에 관심이 있는 개발자.
연구자 – 규칙 엔진 기반 케어 모델, 하이브리드 메모리 검색 또는 안전 중심 설계 AI 실행 파이프라인을 탐구하는 연구자.

더 알아보기

문서 맵 – docs/에는 테스트 기준, 기능 매트릭스, 핵심 메커니즘 가이드, 내부 전달 기록이 포함되어 있습니다.
로드맵 및 상태 – 배지는 프로젝트가 내부 릴리스 후보 단계(rc internal test)에 있음을 보여줍니다.
라이선스 – Apache-2.0 OR MIT 이중 라이선스로 허용 및 카피레프트 모두 사용 가능.

결론: Apeireth는 데이터 주권, 감사 가능한 메모리, 엄격한 인간 개입 제어를 강조하는 완전한 기능의 온디바이스 AI 컴패니언입니다. 코드베이스는 31개 크레이트 Rust 작업 공간으로 구성되어 있으며, 모두 unsafe 없이 작성되었고, 누락된 모든 기능을 공개적으로 문서화합니다.