whatisgithub

What is vic_aisaq_demo?

arpahls/vic_aisaq_demo — explained in plain English

Analysis updated 2026-05-18

2PythonAudience · developerComplexity · 5/5Setup · hard

In one sentence

A demo of a tiered, disk-based search system that finds relevant files by meaning, not just keywords, while using very little memory.

Mindmap

mindmap
  root((vic_aisaq_demo))
    What it does
      Tiered file search
      Low memory usage
      Meaning-based matching
    Tech stack
      Python
      Ollama models
      AiSAQ DiskANN
    Use cases
      Local document search
      Edge AI retrieval
      Benchmarking
    Audience
      Developers
      Storage researchers
    Setup
      WSL build required
      Ollama models needed

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Search large local file collections by meaning instead of exact keywords.

USE CASE 2

Build low-memory, storage-aware retrieval for edge devices or controller-style systems.

USE CASE 3

Benchmark disk-based vector search against traditional retrieval methods.

USE CASE 4

Prototype a local-first, auditable search pipeline for sensitive documents.

What is it built with?

PythonOllamaDiskANNWSLUbuntu

How does it compare?

arpahls/vic_aisaq_demo0-bingwu-0/live-interpreter0xkaz/llm-governance-dashboard
Stars222
LanguagePythonPythonPython
Setup difficultyhardmoderatehard
Complexity5/52/54/5
Audiencedevelopergeneralops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires compiling AiSAQ from source in WSL/Ubuntu and running Ollama with specific local models before anything works.

So what is it?

This project is a demonstration of a smart search system built to work well even on devices with very little memory. It is designed for situations where you want to search through a large pile of files, like documents on a hard drive, and find the ones that actually answer a question, without needing to load everything into RAM first. The system works in three stages, called tiers. First, it filters files using simple details like file type, size, or date, to quickly shrink a huge folder down to a much smaller set of candidates. Second, it uses a technique called vector search, which compares the meaning of text rather than just matching keywords, to find files that are semantically related to the question. This step relies on a storage-friendly search method from KIOXIA called AiSAQ, built to work directly off disk instead of needing everything loaded into memory. Third, only the small number of files that survive the first two rounds get read in full detail, so the expensive part of the process only happens on a short list. The project combines two existing open-source pieces: a retrieval controller called lc0_vic that plans and coordinates the tiered search, and aisaq-diskann, which handles the actual disk-based similarity search. It also uses Ollama, a tool for running AI language models locally, both to turn a plain-English question into a search plan and to convert text into the vectors used for semantic matching. Setting the project up involves compiling the AiSAQ backend from source inside a WSL Ubuntu environment, setting up a Python virtual environment, and running specific local models through Ollama for planning and embeddings. The README frames the project as a systems demonstration rather than a finished product, showing the tradeoff of using less memory in exchange for somewhat higher search latency. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Walk me through how the L0, L1, and L2 tiers in this demo narrow down search results step by step.
Prompt 2
Help me set up the AiSAQ build in WSL following the Quick Start instructions in this README.
Prompt 3
Explain how lc0_vic and aisaq-diskann work together in this project.
Prompt 4
Show me how to run a sample query with scripts/run_query.py and interpret the output metrics.

Frequently asked questions

What is vic_aisaq_demo?

A demo of a tiered, disk-based search system that finds relevant files by meaning, not just keywords, while using very little memory.

What language is vic_aisaq_demo written in?

Mainly Python. The stack also includes Python, Ollama, DiskANN.

How hard is vic_aisaq_demo to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is vic_aisaq_demo for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.