# nekoimagegallery | EdgeNeko | Knowledge Base | Instagit An AI-powered natural language & reverse Image Search Engine powered by CLIP & qdrant. GitHub Stars: 183 Repository: https://github.com/hv0905/nekoimagegallery --- ## Articles ### [How to Add a Custom Storage Backend Implementation in NekoImageGallery](/hv0905/nekoimagegallery/how-to-add-custom-storage-backend-implementation) Learn how to add a custom storage backend implementation in NekoImageGallery. Inherit from BaseStorage, implement methods, and register your class in StorageService for seamless integration. - Tags: how-to-guide - Published: 2026-03-03 ### [How Presigned URL Generation Works for Image Retrieval in NekoImageGallery](/hv0905/nekoimagegallery/how-presigned-url-generation-works-for-image-retrieval) Learn how NekoImageGallery generates presigned URLs for secure image retrieval. Download images directly from storage without exposing credentials or routing traffic. - Tags: how-to-guide - Published: 2026-03-03 ### [MappedImage Structure and Vector Storage in NekoImageGallery: A Complete Technical Guide](/hv0905/nekoimagegallery/what-is-structure-of-mappedimage-and-how-vectors-are-stored) Understand the MappedImage structure for image metadata and dual 768-dimensional vector storage in NekoImageGallery. Learn how vectors are persisted in Qdrant. - Tags: deep-dive - Published: 2026-03-03 ### [How the Admin API Handles Image Upload and Metadata Management in NekoImageGallery](/hv0905/nekoimagegallery/how-admin-api-handles-image-upload-and-metadata-management) Discover how the NekoImageGallery admin API manages image uploads and metadata with SHA-1 ID generation, duplicate protection, and async processing for efficient gallery management. - Tags: how-to-guide - Published: 2026-03-03 ### [NekoImageGallery Model Selection and Device Allocation: A Complete Configuration Guide](/hv0905/nekoimagegallery/what-configuration-options-are-available-for-model-selection-and-device-allocation) Configure NekoImageGallery models CLIP BERT EasyPaddleOCR and device allocation CPU GPU auto for optimal image encoding and text embedding performance. Learn easy setup. - Tags: configuration-guide - Published: 2026-03-03 ### [How the FastAPI Application Is Mounted with an Optional Frontend in NekoImageGallery](/hv0905/nekoimagegallery/how-fastapi-application-is-mounted-with-optional-frontend) Discover how the NekoImageGallery codebase conditionally mounts a React frontend alongside the FastAPI application, enabling dual-mode deployment with API routes prefixed by /api. - Tags: internals - Published: 2026-03-03 ### [How the `/search/similar` Endpoint Finds Visually Similar Images](/hv0905/nekoimagegallery/how-search-similar-endpoint-finds-visually-similar-images) Discover how the "/search/similar" endpoint finds visually similar images using vector embeddings and Qdrant for efficient nearest-neighbor searches with cosine similarity. - Tags: how-to-guide - Published: 2026-03-03 ### [Database Error Handling Patterns in NekoImageGallery: Domain-Driven Exception Design](/hv0905/nekoimagegallery/what-error-handling-patterns-are-used-for-database-operations) Discover NekoImageGallery's domain-driven error handling for database operations. Learn how custom exceptions and ID validation ensure robust error management. - Tags: best-practices - Published: 2026-03-03 ### [NekoImageGallery Lifespan Management: FastAPI Startup and Shutdown Architecture](/hv0905/nekoimagegallery/how-application-manages-lifespan-startup-and-shutdown) Explore the NekoImageGallery lifespan management with FastAPI startup and shutdown. Discover how the ServiceProvider and LifespanService orchestrate application lifecycle hooks in this three-tier architecture. - Tags: architecture - Published: 2026-03-03 ### [How to Configure Qdrant in Server, Local, or Memory Mode](/hv0905/nekoimagegallery/how-to-configure-qdrant-in-server-local-or-memory-mode) Learn to configure Qdrant in server, local, or memory mode for Neko Image Gallery using the APP_QDRANT__MODE variable for flexible vector storage options. - Tags: how-to-guide - Published: 2026-03-03 ### [Filter Parameters for Search Results in Neko Image Gallery: Complete API Reference](/hv0905/nekoimagegallery/what-filter-parameters-are-available-for-filtering-search-results) Explore Neko Image Gallery API filter parameters to refine vector search results. Discover eight filters including aspect ratio, dimensions, starred status, and categories. - Tags: api-reference - Published: 2026-03-03 ### [How NekoImageGallery's Indexing Pipeline Processes and Vectorizes Images](/hv0905/nekoimagegallery/how-indexing-pipeline-processes-and-vectorizes-images) Discover how NekoImageGallery's async indexing pipeline processes images through four stages: upload, preparation, CLIP/BERT vector generation, and Qdrant persistence, creating searchable embeddings. - Tags: internals - Published: 2026-03-03 ### [How NekoImageGallery Extracts and Indexes Text from Images Using PaddleOCR](/hv0905/nekoimagegallery/how-ocr-search-extracts-and-indexes-text-from-images-using-paddleocr) Learn how NekoImageGallery uses PaddleOCR to extract and index image text. Discover its preprocessing, filtering, and hybrid search capabilities for efficient retrieval. - Tags: how-to-guide - Published: 2026-03-03 ### [NekoImageGallery Storage Backends: How to Configure S3-Compatible Storage](/hv0905/nekoimagegallery/what-storage-backends-are-supported-and-how-to-configure-s3-compatible-storage) Configure S3-compatible storage for NekoImageGallery. Learn how to set up object storage using environment variables for efficient image management. - Tags: how-to-guide - Published: 2026-03-03 ### [How NekoImageGallery Verifies Access Tokens and Admin Tokens](/hv0905/nekoimagegallery/how-authentication-system-verifies-access-tokens-and-admin-tokens) Learn how NekoImageGallery verifies access tokens and admin tokens using FastAPI dependency injection comparing header values to configuration files for secure access control. - Tags: how-to-guide - Published: 2026-03-03 ### [How TransformersService Loads and Manages CLIP and BERT Models in NekoImageGallery](/hv0905/nekoimagegallery/how-transformers-service-loads-and-manages-clip-and-bert-models) Discover how NekoImageGallery's TransformersService loads and manages CLIP and BERT models for efficient vector extraction. Learn about its startup initialization and attribute storage. - Tags: internals - Published: 2026-03-03 ### [How the VectorDbContext Class Implements Qdrant Vector Database Operations](/hv0905/nekoimagegallery/how-vector-db-context-implements-qdrant-vector-database-operations) Decipher the VectorDbContext class in NekoImageGallery. Discover how it abstracts Qdrant operations, manages collections, and executes hybrid search for seamless data integration. Learn more now. - Tags: internals - Published: 2026-03-03 ### [SearchBasisEnum.vision vs SearchBasisEnum.ocr: Visual vs Text Search in NekoImageGallery](/hv0905/nekoimagegallery/difference-between-searchbasisenum-vision-and-searchbasisenum-ocr-search-modes) Understand SearchBasisEnum vision vs ocr. Discover how CLIP visual search differs from OCR text search in NekoImageGallery for effective image matching. - Tags: deep-dive - Published: 2026-03-03 ### [How Hybrid Search with RRF Works in Neko Image Gallery: Combining Vision and OCR Embeddings](/hv0905/nekoimagegallery/how-does-hybrid-search-with-rrf-algorithm-work-internally) Discover how Neko Image Gallery uses RRF to combine vision and OCR embeddings for powerful hybrid search. Learn how this fusion creates a unified relevance score from multiple vector spaces. - Tags: internals - Published: 2026-03-03 ### [How the CLIP Model Generates Image Vectors for Vision-Based Search in NekoImageGallery](/hv0905/nekoimagegallery/how-does-clip-model-generate-image-vectors-for-vision-based-search) Learn how the CLIP model generates 768-dimensional image vectors for NekoImageGallery's vision-based search using preprocessing, feature extraction, and normalization for Qdrant. Explore efficient cosine-similarity search. - Tags: deep-dive - Published: 2026-03-03