ApeRAG는 그래프 RAG, 벡터 검색, 전체 텍스트 검색을 고급 AI 에이전트와 결합한 운영 준비가 된 RAG(검색 증강 생성) 플랫폼입니다. 하이브리드 검색, 다중 모달 문서 처리, 지능형 에이전트, 엔터프라이즈급 관리 기능을 갖춘 정교한 AI 애플리케이션을 구축할 수 있습니다.

ApeRAG는 자체 지식 그래프, 컨텍스트 엔지니어링, 그리고 지식 기반을 자율적으로 탐색하고 추론할 수 있는 지능형 AI 에이전트를 배포하기에 가장 좋은 선택입니다.

阅读中文文档

• 퀵 스타트
• 주요 특징
• Kubernetes 배포 (운영 권장)
• 개발
• 도커 이미지 구축
• 감사의 글
• 면허

퀵 스타트

ApeRAG를 설치하기 전에 컴퓨터가 다음 최소 시스템 요구사항을 충족하는지 확인하세요:

• CPU >= 2코어
• RAM >= 4 GiB
• Docker 및 Docker Compose

ApeRAG를 시작하는 가장 쉬운 방법은 Docker Compose를 통해서입니다. 다음 명령을 실행하기 전에, Docker와 Docker Compose가 귀하의 컴퓨터에 설치되어 있는지 확인하세요:

실행 후에는 다음 브라우저에서 ApeRAG에 접속할 수 있습니다:

• 웹 인터페이스: http://localhost:3000/web/
• API 문서: http://localhost:8000/docs

ApeRAG

ApeRAG is a production-ready RAG (Retrieval-Augmented Generation) platform that combines Graph RAG, vector search, and full-text search with advanced AI agents. Build sophisticated AI applications with hybrid retrieval, multimodal document processing, intelligent agents, and enterprise-grade management features.

ApeRAG is the best choice for building your own Knowledge Graph, Context Engineering, and deploying intelligent AI agents that can autonomously search and reason across your knowledge base.

阅读中文文档

• Quick Start
• Key Features
• Kubernetes Deployment (Recommended for Production)
• Development
• Build Docker Image
• Acknowledgments
• License

Quick Start

Before installing ApeRAG, make sure your machine meets the following minimum system requirements:

• CPU >= 2 Core
• RAM >= 4 GiB
• Docker & Docker Compose

The easiest way to start ApeRAG is through Docker Compose. Before running the following commands, make sure that Docker and Docker Compose are installed on your machine:

git clone https://github.com/apecloud/ApeRAG.git
cd ApeRAG
cp envs/env.template .env
docker-compose up -d --pull always

After running, you can access ApeRAG in your browser at:

• Web Interface: http://localhost:3000/web/
• API Documentation: http://localhost:8000/docs

MCP (Model Context Protocol) Support

ApeRAG supports MCP (Model Context Protocol) integration, allowing AI assistants to interact with your knowledge base directly. After starting the services, configure your MCP client with:

{
  "mcpServers": {
    "aperag-mcp": {
      "url": "http://localhost:8000/mcp/",
      "headers": {
        "Authorization": "Bearer your-api-key-here"
      }
    }
  }
}

Authentication (by priority):

1. HTTP Authorization Header (Recommended): Authorization: Bearer your-api-key
2. Environment Variable (Fallback): APERAG_API_KEY=your-api-key

Important: Use your deployed API origin if not local (e.g. https://your-host/mcp/). Replace your-api-key-here with a valid API key from your ApeRAG settings.

The MCP server provides:

• Collection browsing: List and explore your knowledge collections
• Hybrid search: Search using vector, full-text, and graph methods
• Intelligent querying: Ask natural language questions about your documents

Enhanced Document Parsing