Universal Vector Database Tool 🔍

Semantic search for any file type - powered by Qdrant, FastAPI, and React.

🚀 Quick Access

Service URLs: (randomly assigned ports from 50000-60000)

• Web UI: http://localhost:58778 👈 Start here!
• Backend API: http://localhost:53264
• API Docs: http://localhost:53264/docs
• Qdrant: http://localhost:59595

⚡ Quick Start

# Start all services
docker-compose up -d

# Check status
docker-compose ps

# Open web UI
open http://localhost:58778  # macOS
xdg-open http://localhost:58778  # Linux

See DOCKER-QUICK-START.md for complete instructions.

---

Overview

The purpose of this repo is to take unstructured data and update a Qdrant database.

🚨 ATTENTION ALL AI CODING ASSISTANTS 🚨

ALL HISTORY OF THIS PROJECT MUST BE MAINTAINED IN project-history.md. It should hold the past, present and future. Make sure this has a table of contents, and that there are at least 3 H2 headings: past, present, and future

This protocol MUST be followed by ALL AI tools: Claude Code, Gemini CLI, Qwen CLI, Kilo Code Extension, Codex Extension, and any other AI coding assistant.

Read in and follow the directions laid out by this file: ai-chats/README.md with every exchange with the dev user!

^ REMEMBER THIS AT ALL TIMES!!

Current Requirements

First thing we need is a well defined PRD, but let's start with this information to base it on. AI, ask me questions and work with me to help you help me create this well defined PRD which will be put in a file ./docs/PRD.md.

Here we go:

• I want a numbered menu based script utility out of this repo.
• When the script(s) (I'd like to primarily focus on linux bash scripts, but eventually, I'd like counterpart scripts for other OS's) are run, all the files and sub-folders are shown from the root-of-git-repo.
• There is a folder here called root-of-git-repo. All or some of the contents should be copied to every repo found within a particular path (entered by the dev user - default will be ~/src)
• This allows me to make one edit in one repo (this one), and copy it all out to all of my other repos.

help me bang out the rest of the requirements!

---

I want to be able to drop files and any/all unsctructured content into a subfolder here in this repo and this app will add it to our vector database. which is the best vector db for our purposes?