기능

AQBot은 멀티 프로바이더 채팅, 강력한 콘텐츠 렌더링, 도구 통합, 내장 API 게이트웨이를 모두 갖춘 완전한 기능의 데스크톱 AI 어시스턴트입니다 — 모두 로컬에서 강력한 데이터 보안으로 실행됩니다.

채팅 및 모델

단일 통합 인터페이스에서 주요 AI 프로바이더에 연결하세요. AQBot이 백그라운드에서 API 차이를 처리하므로 대화에 집중할 수 있습니다.

• 멀티 프로바이더 지원 — OpenAI, Anthropic Claude, Google Gemini 및 모든 OpenAI 호환 API와 호환. 각 프로바이더는 자체 API 키, Base URL, 모델 목록으로 독립적으로 구성됩니다.
• 모델 관리 — 원격 모델 목록을 자동으로 가져오고 대화별로 온도, 최대 토큰, top-p 등의 생성 매개변수를 맞춤 설정합니다.
• 멀티 키 로테이션 — 프로바이더별로 여러 API 키를 구성하고 자동 로테이션으로 속도 제한 부하를 분산하고 가동 시간을 최대화합니다.
• 스트리밍 출력 — 실시간 토큰별 렌더링으로 모델이 생성하는 동안 항상 파악할 수 있습니다. 접을 수 있는 사고 블록으로 대화를 방해하지 않고 모델의 사고 과정을 확인할 수 있습니다.
• 메시지 버전 — 모든 응답에 여러 버전을 가질 수 있습니다. 다른 모델이나 매개변수 설정의 효과를 나란히 비교할 수 있습니다.
• 대화 브랜치 — 임의의 메시지 노드에서 새 브랜치를 분기하여 대안적인 방향을 탐색합니다. 나란히 브랜치 비교 뷰로 다른 경로를 쉽게 평가할 수 있습니다.
• 대화 관리 — 중요한 대화를 고정하고, 오래된 것을 보관하고, 시간 그룹화된 기록을 탐색하고, 작업 공간을 깔끔하게 유지하기 위한 일괄 작업을 수행합니다.
• 대화 압축 — 긴 대화를 자동으로 압축하여 핵심 정보를 유지하면서 컨텍스트 공간을 절약합니다.
• 멀티 모델 동시 응답 — 같은 질문을 여러 모델에 동시에 묻고 답변을 나란히 비교합니다.

AI Agent

AQBot에는 AI가 세밀한 권한 제어 하에 자율적으로 다단계 작업을 수행할 수 있는 내장 Agent 모드가 포함되어 있습니다.

• Agent 모드 — 모든 대화를 Agent 모드로 전환하여 자율적 작업 수행. AI가 파일 읽기/쓰기, 셸 명령어 실행, 코드 분석, 복잡한 다단계 워크플로우 수행 가능 — 모두 제어된 환경 내에서 실행
• 3단계 권한 — 워크플로우에 적합한 안전 수준 선택:
  • 기본 — 읽기 작업은 자동 승인; 쓰기 및 명령어 실행은 사용자의 명시적 승인 필요
  • 편집 수락 — 파일 읽기/쓰기 자동 승인; 명령어 실행은 여전히 승인 필요
  • 전체 액세스 — 모든 작업이 프롬프트 없이 진행 (경로 안전 검사는 계속 적용)
• 작업 디렉토리 샌드박스 — Agent의 모든 파일 작업은 지정된 작업 디렉토리로 엄격히 제한. 경로 탐색, 심볼릭 링크 탈출, 샌드박스 외부 접근은 시스템 수준에서 차단
• 도구 승인 패널 — 모든 도구 호출이 매개변수와 함께 실시간 표시. 개별 검토, "항상 허용" 클릭으로 결정 기억, 또는 신뢰할 수 없는 작업 거부
• 비용 추적 — 각 Agent 세션의 토큰 사용량과 예상 USD 비용을 실시간 모니터링

Beta 기능

Agent 모드는 현재 Beta입니다. open-agent-sdk를 통해 OpenAI, Anthropic, Gemini 모델을 지원합니다.

콘텐츠 렌더링

AQBot은 풍부하고 인터랙티브한 렌더링 파이프라인으로 일반 텍스트 채팅을 훨씬 넘어섭니다.

• Markdown 렌더링 — 구문 강조 코드 블록, LaTeX 수식, 테이블, 작업 목록을 완전 지원.
• Monaco 코드 에디터 — 코드 블록에 Monaco 에디터(VS Code의 엔진)를 내장하여 구문 강조, 원클릭 복사, 인라인 diff 미리보기 제공.
• 다이어그램 렌더링 — Mermaid 플로우차트와 D2 아키텍처 다이어그램을 내장 렌더링하여 대화에 직접 표시.
• Artifact 패널 — 코드 스니펫, HTML 초안, Markdown 노트, 보고서를 전용 사이드 패널에서 집중적으로 보고 편집합니다.
• 실시간 음성 채팅 — (출시 예정) 저지연 자연스러운 상호작용을 위한 OpenAI Realtime API를 사용한 WebRTC 기반 음성 대화.

검색 및 지식

실시간 웹 데이터, 로컬 문서, 지속적인 메모리로 대화를 강화합니다.

• 웹 검색 — Tavily, Zhipu WebSearch, Bocha 등과 통합. 검색 결과에는 인용 출처 주석이 포함되어 한눈에 주장을 확인할 수 있습니다.
• 로컬 지식 베이스(RAG) — 여러 지식 베이스를 지원합니다. 문서를 업로드하면 자동으로 파싱, 청크화, 벡터 인덱싱(sqlite-vec)됩니다. 대화 중 관련 구절이 의미론적으로 검색되어 자동으로 컨텍스트에 주입됩니다.
• 메모리 시스템 — 멀티 네임스페이스 대화 메모리를 지원합니다. 항목은 수동으로 추가하거나 AI가 자동으로 추출할 수 있습니다(자동 추출은 출시 예정). 메모리는 대화 간에 유지되어 모델에 장기적인 인식을 제공합니다.
• 컨텍스트 관리 — 파일 첨부, 검색 결과, 지식 베이스 구절, 메모리 항목, 도구 출력을 임의의 메시지에 유연하게 첨부하여 정밀한 컨텍스트 제어가 가능합니다.

출시 예정

AI 기반 자동 메모리 추출은 현재 개발 중이며 다음 릴리스에서 제공될 예정입니다.

도구 및 확장

외부 도구와 강력한 명령 인터페이스로 모델의 기능을 확장합니다.

• MCP 프로토콜 — stdio 및 HTTP 전송을 모두 지원하는 완전한 Model Context Protocol 구현. 로컬 도구 서버나 원격 엔드포인트에 원활하게 연결.
• 내장 도구 — @aqbot/fetch 등 별도 설정 없이 바로 사용할 수 있는 내장 MCP 도구.
• 도구 실행 패널 — 각 도구 호출 요청과 반환 결과를 시각적 패널로 표시하여 도구 상호작용을 쉽게 감사하고 디버그할 수 있습니다.

API 게이트웨이

AQBot에는 데스크톱 앱을 강력한 AI 게이트웨이로 전환하는 내장 로컬 API 서버가 포함되어 있습니다.

• 로컬 API 게이트웨이 — OpenAI 호환, Claude, Gemini 인터페이스를 기본 지원하는 로컬 서버를 노출합니다. CLI 도구, 스크립트 또는 기타 애플리케이션의 백엔드로 사용하세요.
• API 키 관리 — 액세스 키 생성, 취소, 활성화 또는 비활성화. 각 키에는 쉬운 식별을 위한 설명 메모를 지원합니다.
• 사용량 분석 — 키, 프로바이더, 날짜별로 세분화된 요청 볼륨과 토큰 사용량을 분석합니다.
• SSL/TLS 지원 — 사용자 지정 인증서 가져오기를 지원하는 내장 자가 서명 인증서 생성.
• 요청 로그 — 감사 및 디버깅을 위해 게이트웨이를 통과하는 모든 API 요청 및 응답의 완전한 기록.
• 구성 템플릿 — Claude Code, Codex CLI, OpenCode, Gemini CLI 등 인기 있는 도구를 위한 사전 구축된 통합 템플릿.

로컬 게이트웨이를 사용하는 이유

게이트웨이를 통해 AQBot을 모든 도구의 통합 AI 백엔드로 사용할 수 있습니다. CLI 클라이언트, IDE 확장 프로그램 또는 사용자 지정 스크립트를 로컬 게이트웨이로 향하게 하여 키 로테이션, 사용량 추적, 액세스 제어의 이점을 누리세요.

데이터 및 보안

데이터는 당신의 기기에서 벗어나지 않습니다. AQBot은 모든 계층에서 로컬 우선 보안으로 설계되었습니다.

• AES-256 암호화 — API 키 및 기타 민감한 데이터는 AES-256으로 로컬 암호화됩니다. 마스터 암호화 키는 0600 파일 권한으로 저장됩니다(Unix 시스템에서 소유자만 액세스 가능).
• 격리된 데이터 디렉토리 — 애플리케이션 상태(데이터베이스, 암호화 키, 벡터 인덱스)는 ~/.aqbot/에 저장됩니다. 사용자가 볼 수 있는 파일(이미지, 문서, 백업)은 표준 OS 도구로 쉽게 액세스하고 백업할 수 있는 ~/Documents/aqbot/에 저장됩니다.
• 자동 백업 — 로컬 디렉토리나 WebDAV 스토리지로 자동 백업을 예약합니다.
• 백업 복원 — 임의의 과거 백업에서 원클릭으로 전체 작업 공간을 복원합니다.
• 대화 내보내기 — 대화를 PNG 스크린샷, Markdown 문서, 일반 텍스트 또는 구조화된 JSON으로 내보냅니다.

마스터 키를 보호하세요

파일 ~/.aqbot/master.key는 AQBot의 모든 암호화의 루트입니다. 안전하게 보관하고 백업에 포함하세요. 이 키를 잃으면 암호화된 데이터를 복구할 수 없습니다.

데스크톱 경험

AQBot은 일상적인 도구로서 기대하는 세련미와 통합을 갖춘 네이티브 데스크톱 애플리케이션으로 구축되었습니다.

• 테마 전환 — 시스템 기본 설정을 따르거나 수동으로 설정할 수 있는 다크 및 라이트 테마.
• 인터페이스 언어 — 한국어, 간체 중국어, 영어를 완전 지원하며 설정에서 언제든지 전환 가능.
• 시스템 트레이 — 창 닫을 때 시스템 트레이로 최소화. API 게이트웨이 등의 백그라운드 서비스는 중단 없이 계속 실행됩니다.
• 항상 위에 표시 — 빠른 참조 워크플로를 위해 메인 창을 다른 모든 창 위에 고정합니다.
• 전역 단축키 — 어디서나 언제든지 메인 창을 불러오기 위한 사용자 지정 가능한 전역 키보드 단축키.
• 자동 시작 — 항상 준비된 상태로 있도록 시스템 시작 시 AQBot을 선택적으로 시작합니다.
• 프록시 지원 — 네트워크 액세스가 제한된 환경을 위한 HTTP 및 SOCKS5 프록시 구성.
• 자동 업데이트 — 시작 시 새 버전을 자동으로 확인하고 원클릭으로 업데이트하도록 안내합니다.