git404hub

what is bloblens fr?

haseeb-140/bloblens — explained in plain English

Analysis updated 2026-05-18

23PythonAudience · ops devopsComplexity · 3/5LicenseSetup · easy

tl;dr

A self-hosted search tool for Azure Blob Storage that finds text inside PDFs and Word documents, running for free via one Docker command.

vibe map

mindmap
  root((BlobLens))
    What it does
      Full text search
      Search inside PDFs
      Incremental sync
    Tech stack
      Python
      FastAPI
      Meilisearch
      Docker
    Use cases
      Searching cloud file storage
      Replacing paid Azure Search
      Self hosted document search
    Audience
      DevOps engineers
      Small teams on Azure

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 make with this?

VIBE 1

Search inside PDFs and Word documents stored in an Azure Blob Storage account without paying for Azure AI Search.

VIBE 2

Run a self-hosted, free search interface over cloud file storage with one Docker command.

VIBE 3

Set up incremental syncing so only new or changed files are re-indexed over time.

VIBE 4

Generate short-lived download links for files found through search results.

what's the stack?

PythonFastAPIMeilisearchDocker

how it stacks up fr

haseeb-140/bloblensaaravkashyap12/advise-project-approachabu-rayhan-alif/django-saas-kit
Stars232323
LanguagePythonPythonPython
Setup difficultyeasyeasymoderate
Complexity3/52/53/5
Audienceops devopsdeveloperdeveloper

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

how do i run it?

Difficulty · easy time til it works · 30min

Needs an Azure Storage connection string and Docker installed.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

BlobLens is a self-hosted search tool for Azure Blob Storage, the file storage service in Microsoft's cloud. It lets you search not just file names, but the actual text inside PDF and Word documents stored across your storage containers. The project positions itself as a free alternative to Azure's own AI Search product, which the README says can cost from about 75 to 250 dollars or more per month, while BlobLens runs on a small server for no extra cost. Setting it up means cloning the project, adding your Azure storage connection string to a configuration file, and running a single Docker command. Once started, a background worker begins scanning your storage containers and extracting text from supported file types, including PDFs, Word documents, and many plain text and code file formats. That extracted text, along with details like file name, size, and last modified date, gets sent to Meilisearch, a fast open source search engine, which powers a search-as-you-type web interface at localhost port 8000. To keep repeated scans cheap, the worker only re-downloads files that changed since the last pass, tracking this using each container's last modified timestamps. Very large files skip text extraction and are indexed by metadata only. When you want to open a file, the app generates a temporary, time-limited download link rather than storing or proxying the file itself. The README is clear that BlobLens has no login system of its own and is meant to run inside a private network, behind a VPN or your own authentication layer. It also lists planned future features, including automatic detection and redaction of sensitive information like emails and ID numbers before indexing. The project is released under the MIT license.

prompts (copy fr)

prompt 1
Walk me through setting up BlobLens with docker compose and my Azure storage connection string.
prompt 2
Explain how BlobLens's incremental sync avoids re-downloading unchanged blobs.
prompt 3
Show me how to use the /api/search endpoint to filter results by container and file extension.
prompt 4
Help me configure MAX_TEXT_CHARS and MAX_BLOB_MB in the .env file for large PDF files.

Frequently asked questions

what is bloblens fr?

A self-hosted search tool for Azure Blob Storage that finds text inside PDFs and Word documents, running for free via one Docker command.

What language is bloblens written in?

Mainly Python. The stack also includes Python, FastAPI, Meilisearch.

What license does bloblens use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is bloblens to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is bloblens for?

Mainly ops devops.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.