TL;DR

Gini Agent는 개인용 에이전트를 로컬 우선 런타임으로 제공하여 대화뿐만 아니라 장기 메모리, 작업 실행, 승인, 도구 접근을 하나의 상태 소스에서 관리한다. 아키텍처는 인스턴스당 하나의 Bun 게이트웨이가 상태와 에이전트 루프를 소유하고 Next.js BFF, CLI, 모바일 클라이언트가 공통 /api 계약으로 연결되는 구조를 사용하며 공급자 설정을 통해 OpenAI·Anthropic·Bedrock·Azure 등 다양한 모델을 통합할 수 있다. 보안 카드와 인라인 승인 같은 목적별 컨트롤은 비밀이 대화나 로그에 남지 않도록 설계되어 있으며 병렬 인스턴스와 마이그레이션 도구는 운영·개발 유연성을 제공한다. 설치는 제공된 curl 설치 스크립트나 Bun 기반 로컬 빌드 명령으로 시작할 수 있고 주요 제약은 Bun 런타임과 공급자별 인증 자격증명이다.

핵심 포인트

• 게이트웨이 중심 아키텍처를 통해 런타임이 상태와 실행을 소유하도록 설계되어 클라이언트 간 일관성이 확보된다. 한 인스턴스당 하나의 Bun 프로세스가 상태를 관리하며 모든 클라이언트가 동일한 /api 계약으로 통신하기 때문에 상태 동기화와 권한 모델을 단순화한다. 이 방식은 단순한 채팅 프론트엔드가 아닌 실행 가능한 런타임을 제공하는 데 초점이 맞춰져 있다.
• 민감 정보 처리를 위한 목적별 인라인 컨트롤이 기본 요소로 제공되어 비밀이 대화나 로그에 남지 않도록 설계되었다. 비밀번호·OTP·결제 정보 등은 보안 카드로 직접 게이트웨이에 전달되며 모델 트랜스크립트나 감사 로그에 포함되지 않는다. 이러한 접근은 권한 검증과 사용자 승인 흐름을 에이전트 논리와 분리하여 보안성과 사용자 경험을 동시에 개선한다.
• 광범위한 공급자 통합을 통해 클라우드 제공 모델과 로컬 OpenAI 호환 서버를 동시 지원하므로 사용자가 환경에 맞춰 모델을 선택하거나 전환할 수 있다. 각 공급자별로 필요한 인증 방식과 엔드포인트를 CLI 또는 웹에서 설정할 수 있으며 Codex OAuth와 같은 특수한 인증 흐름도 지원된다. 이로 인해 프로덕션 환경에서 모델 제공자 종속성을 줄이고 다양한 배포 시나리오를 수용할 수 있다.
• 로컬 인증 게이트웨이를 실행하여 대화, 실행 기록, 작업, 승인, 메모리, 스킬을 단일 상태 저장소에서 관리한다. 게이트웨이는 각 인스턴스마다 Bun 프로세스로 구동되어 상태와 작업을 소유하며 클라이언트는 공통 /api 계약을 통해 접근한다. 이 구조는 런타임 일관성을 유지하면서 여러 클라이언트가 동일한 에이전트 상태를 공유하도록 설계되어 있다.