MajorMonge/rag-dt

A full-stack, Retrieval Augmented Generation (RAG) system for technical documentation querying with a chat interface.

★ 0Forks 0GitHub ↗Compare

README

RAG-DT - MailMind AI Documentation Assistant

A full-stack, Retrieval Augmented Generation (RAG) system for technical documentation querying with a chat interface.

🌐 English | Português


English

📦 Project Structure

This monorepo contains two main projects:

Project Description Tech Stack
rag-dt-backend RAG API with document ingestion, vector embeddings, and semantic search Express, TypeScript, LangChain, ChromaDB, OpenAI
rag-dt-frontend Chat interface for natural language documentation queries Next.js 16, React, TypeScript, Tailwind CSS, daisyUI

✨ Features

  • Automatic Document Ingestion - Load and index Markdown documentation from local directories
  • Vector Embeddings - Generate embeddings using OpenAI models via OpenRouter
  • Semantic Search - Retrieve relevant context using ChromaDB similarity search
  • RAG Pipeline - Complete question-answering with context injection

🚀 Quick Start

  1. Start the backend:

    cd rag-dt-backend
    cp .env.example .env
    docker-compose up -d
    npm install
    npm run dev

    API available at http://localhost:3000

  2. Start the frontend:

    cd rag-dt-frontend
    cp .env.example .env
    npm install
    npm run dev

    App available at http://localhost:4000

📚 Documentation


Português

📦 Estrutura do Projeto

Este monorepo contém dois projetos principais:

Projeto Descrição Tecnologias
rag-dt-backend API RAG com ingestão de documentos, embeddings vetoriais e busca semântica Express, TypeScript, LangChain, ChromaDB, OpenAI
rag-dt-frontend Interface de chat para consultas Next.js 16, React, TypeScript, Tailwind CSS, daisyUI

✨ Funcionalidades

  • Ingestão Automática de Documentos - Carrega e indexa documentação Markdown de diretórios locais
  • Embeddings Vetoriais - Gera embeddings usando modelos OpenAI via OpenRouter
  • Busca Semântica - Recupera contexto relevante usando busca por similaridade ChromaDB
  • Pipeline RAG - Sistema completo de perguntas e respostas com injeção de contexto

🚀 Início Rápido

  1. Iniciar o backend:

    cd rag-dt-backend
    cp .env.example .env
    docker-compose up -d
    npm install
    npm run dev

    API disponível em http://localhost:3000

  2. Iniciar o frontend:

    cd rag-dt-frontend
    cp .env.example .env
    npm install
    npm run dev

    App disponível em http://localhost:4000

📚 Documentação

  • Docs da API: http://localhost:3000/docs (Swagger UI)
  • Veja os READMEs individuais dos projetos para instruções detalhadas de configuração

Contributors

MajorMonge

Issues