RagLeap
Guides

Guides for every package

26 guides across 17 packages, mirrored from the GitHub wiki and each package's docs. Pick a package to filter.

Getting Started

You'll need a PostgreSQL database with the pgvector extension enabled, and an API key for at least one supported provider (Gemini, Anthropic, OpenAI…

Architecture

This page mirrors the "How it fits together" diagram in the README — verified against real, current source ( inspect.signature() checks against…

Core Engine — AI Employees

Scope note: this page documents ragleap-core 's engine ( core/ , channels/ ), not the ragleap-rag / ragleap-graph pip packages covered by the rest of…

Core Engine — n8n Workflow Automation

Scope note: this page documents ragleap-core 's engine ( core/ , channels/ ), not the ragleap-rag / ragleap-graph pip packages covered by the rest of…

Vector Backends

ragleap-rag supports 6 vector storage backends. 2 are live-verified against a real service; 4 are code-complete but not yet live-tested — this is…

Migration Guide

Moving from LangChain or LlamaIndex? The full guide with 5 real, runnable side-by-side comparisons lives at MIGRATION.md in the repo root. This page…

Benchmarks

All numbers below come from a real, timed run against real infrastructure — never projected or estimated. Full methodology, raw results, and…

FAQ & Honest Limitations

No agentic AI / tool-calling. This is a RAG engine — text in, grounded answer out. No agent reasoning loop, no tool-calling. That's planned as…

Contributing

ragleap-rag is open source and welcomes contributions. This page covers the practical mechanics; project values are in Roadmap and the repo's…

ragleap-graph package guide

Knowledge-graph-augmented retrieval for RAG systems — entity extraction, co-occurrence graphs, and graph-based document retrieval via Neo4j.

ragleap-vectorstores package guide

Pluggable vector backends beyond ragleap-rag 's built-in 6 (PgVector, FAISS, Pinecone, Weaviate, Qdrant, Milvus).

ragleap-tools package guide

Standalone, dependency-light tool implementations for LLM tool-calling. Exposes OpenAI-, Gemini- and Anthropic-style function-calling schemas.

ragleap-observability package guide

Metrics, logs, and alerting for RagLeap Core -- Prometheus, Grafana, Loki, and AlertManager, wired against the real db/app/voice/neo4j services.

ragleap-ops package guide

Kubernetes deployment manifests for RagLeap Core.

ragleap-ops runbook

Operational playbooks for the 4 minimum incident scenarios flagged in the DevOps maturity plan: db-down, neo4j-crash-loop, backup-failure-detected, in…

ragleap-app-chart package guide

A generic, reusable Helm chart for deploying arbitrary services to Kubernetes — built by RagLeap, but not specific to RagLeap.

ragleap-rag package guide

A fast, honest, self-hosted RAG engine. Hybrid dense+sparse retrieval, real streaming, automatic provider fallback, and actual token usage numbers — n…

ragleap-integrations package guide

An MCP (Model Context Protocol) client that turns allowlisted tools on remote MCP servers into ragleap_tools.Tool objects, so MCP tools and native too…

ragleap-agents package guide

A small agent loop over ragleap-tools Tool objects. The model proposes one action at a time , sees the result, and proposes the next, up to a hard ste…

ragleap-terraform package guide

Terraform module that creates a local kind cluster and installs the RagLeap Helm charts onto it. Tested on a real cluster; no cloud modules yet.

ragleap-ansible package guide

Ansible roles that prepare a fresh Ubuntu 22.04 server for the RagLeap Helm charts. Version 0.1.0 covers the server base only. It does not install k3s…

ragleap-voice package guide

Open-source (MIT), local-first speech tooling, with Indian languages as a priority.

ragleap-memory package guide

Durable, tenant-scoped long-term memory for LLM applications. Alpha. Not independently audited : see docs/threat-model.md for exactly what is and is n…

ragleap-security package guide

Small, auditable security primitives for the ragleap libraries. The core is standard library only; encryption is an optional extra. Alpha. Not indepen…

ragleap-trace package guide

Dependency-free tracing for RagLeap. Standard library only ( dependencies = [] ). Version 0.1.0: spans, a tracer, two exporters, and an adapter for ra…

ragleap-optimizer package guide

A measure-first layer that reduces the token use of LLM requests. Alpha. Not independently audited : see docs/threat-model.md for exactly what is and…