Skip to content

NamelyCorp/NamelyCorp-Vector-DB-RAG

Repository files navigation

NamelyCorp

NamelyCorp VectorDB RAG

Production-grade Retrieval-Augmented Generation (RAG) and semantic search system built in PHP with Qdrant (vector DB) and Ollama (embeddings / local LLM). Upload documents, chunk + embed, store vectors, and query your own data through a clean Web UI and REST API.

Important: This release contains no external authentication provider. All authentication code has been removed and replaced with a simple stub in includes/auth.php. See that file if you wish to enable your own login.

Web UI

The UI includes:

  • AI Chat (RAG), Hybrid/Vector Search, Upload & Index, Browse, Jobs, and Manage (health, stats, delete-by-source, model discovery).

Screenshot Gallery

UI Preview
AI Chat
Search
Upload
Browse
Jobs
Manage

Features

This system is production-tested and actively maintained by NamelyCorp. Key capabilities include:

  • Semantic + Hybrid Search – dense vector search blended with keyword-based retrieval for precise and recall‑friendly results.
  • Multi‑format ingestion – supports PDF, DOCX, XLSX/CSV, Markdown/HTML, code snippets and even images via OCR. Files are automatically chunked and embedded before indexing.
  • Background processing – uploads are queued and processed asynchronously by a dedicated worker, ensuring the UI remains responsive.
  • Comprehensive REST API – programmatically upload, search, list, delete, and query system health and statistics.
  • Self‑hosted – keep your documents and vectors on your own infrastructure.
  • Flexible configuration – everything can be configured via config.php or environment variables.

Quickstart (5 minutes)

See QUICKSTART.md for the fast path.

Prerequisites

  • PHP 8.1+ with common extensions (curl, json, mbstring, zip)
  • Docker + Compose (recommended) to run Qdrant and (optionally) Ollama
  • Optional tools for richer ingestion: pdftotext, pandoc, tesseract (OCR)

1) Configure

cp config.example.php config.php

2) Start services

docker compose up -d

3) Run locally

php -S 0.0.0.0:8000

Open: http://localhost:8000

Deployment

  • Apache/Nginx: point a vhost at this directory and ensure uploads/, queue/, and logs/ are writable.
  • Security: protect the app with HTTP Basic Auth or reverse-proxy auth if you expose it publicly.

Release Quality

  • validate_release.sh checks for internal references and common packaging issues.
  • examples/test-api.sh provides a smoke test for the API.

Built and maintained by NamelyCorp with ❤️LY © NamelyCorp. All rights reserved.