nekoimagegallery
An AI-powered natural language & reverse Image Search Engine powered by CLIP & qdrant.
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.
How Presigned URL Generation Works for Image Retrieval in NekoImageGalleryLearn how NekoImageGallery generates presigned URLs for secure image retrieval. Download images directly from storage without exposing credentials or routing traffic.
MappedImage Structure and Vector Storage in NekoImageGallery: A Complete Technical GuideUnderstand the MappedImage structure for image metadata and dual 768-dimensional vector storage in NekoImageGallery. Learn how vectors are persisted in Qdrant.
How the Admin API Handles Image Upload and Metadata Management in NekoImageGalleryDiscover how the NekoImageGallery admin API manages image uploads and metadata with SHA-1 ID generation, duplicate protection, and async processing for efficient gallery management.
NekoImageGallery Model Selection and Device Allocation: A Complete Configuration GuideConfigure NekoImageGallery models CLIP BERT EasyPaddleOCR and device allocation CPU GPU auto for optimal image encoding and text embedding performance. Learn easy setup.
How the FastAPI Application Is Mounted with an Optional Frontend in NekoImageGalleryDiscover how the NekoImageGallery codebase conditionally mounts a React frontend alongside the FastAPI application, enabling dual-mode deployment with API routes prefixed by /api.
How the `/search/similar` Endpoint Finds Visually Similar ImagesDiscover how the "/search/similar" endpoint finds visually similar images using vector embeddings and Qdrant for efficient nearest-neighbor searches with cosine similarity.
Database Error Handling Patterns in NekoImageGallery: Domain-Driven Exception DesignDiscover NekoImageGallery's domain-driven error handling for database operations. Learn how custom exceptions and ID validation ensure robust error management.
NekoImageGallery Lifespan Management: FastAPI Startup and Shutdown ArchitectureExplore the NekoImageGallery lifespan management with FastAPI startup and shutdown. Discover how the ServiceProvider and LifespanService orchestrate application lifecycle hooks in this three-tier architecture.
How to Configure Qdrant in Server, Local, or Memory ModeLearn to configure Qdrant in server, local, or memory mode for Neko Image Gallery using the APP_QDRANT__MODE variable for flexible vector storage options.
Filter Parameters for Search Results in Neko Image Gallery: Complete API ReferenceExplore Neko Image Gallery API filter parameters to refine vector search results. Discover eight filters including aspect ratio, dimensions, starred status, and categories.
How NekoImageGallery's Indexing Pipeline Processes and Vectorizes ImagesDiscover how NekoImageGallery's async indexing pipeline processes images through four stages: upload, preparation, CLIP/BERT vector generation, and Qdrant persistence, creating searchable embeddings.
Have a question about this repo?
These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:
curl -s "https://instagit.com/install.md" 
Maintain an open-source project? Get it listed too →