{"id":27309230,"url":"https://github.com/itzcrazykns/neon-image-search","last_synced_at":"2025-08-21T10:18:11.713Z","repository":{"id":223239036,"uuid":"759677941","full_name":"ItzCrazyKns/Neon-Image-Search","owner":"ItzCrazyKns","description":"Search for similar images using NeonDB and Vertex AI.","archived":false,"fork":false,"pushed_at":"2024-02-19T06:09:07.000Z","size":13045,"stargazers_count":40,"open_issues_count":1,"forks_count":11,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-12T05:28:54.811Z","etag":null,"topics":["ai","artificial-intelligence","embeddings","image-search","image-search-engine","machine-learning","neondb","neondb-vector","pgvector","search-images","vertexai"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ItzCrazyKns.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2024-02-19T05:55:38.000Z","updated_at":"2025-01-21T12:07:16.000Z","dependencies_parsed_at":"2024-02-19T07:40:19.700Z","dependency_job_id":null,"html_url":"https://github.com/ItzCrazyKns/Neon-Image-Search","commit_stats":null,"previous_names":["itzcrazykns/neon-image-search"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ItzCrazyKns/Neon-Image-Search","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItzCrazyKns%2FNeon-Image-Search","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItzCrazyKns%2FNeon-Image-Search/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItzCrazyKns%2FNeon-Image-Search/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItzCrazyKns%2FNeon-Image-Search/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ItzCrazyKns","download_url":"https://codeload.github.com/ItzCrazyKns/Neon-Image-Search/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItzCrazyKns%2FNeon-Image-Search/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271462097,"owners_count":24763860,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-21T02:00:08.990Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","artificial-intelligence","embeddings","image-search","image-search-engine","machine-learning","neondb","neondb-vector","pgvector","search-images","vertexai"],"created_at":"2025-04-12T05:24:50.169Z","updated_at":"2025-08-21T10:18:11.690Z","avatar_url":"https://github.com/ItzCrazyKns.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Neon Image Search\n\nThis is an image search app, built using NeonDB and Vertex AI. It uses Vertex AI to convert the data images into embeddings and then stores it into NeonDB. When a request is made the request image is converted into embeddings and then the similarity search is performed by NeonDB using PGVector.\n\n![preview](./assets//app_preview.png)\n\n\n## How it works?\n\nIt starts by first converting the data images stored in the `public/flower_images` folder into embeddings. Embeddings are high-dimensional vectors that represent the images in a format that computers can understand and process. This conversion is done using Google Cloud's Vertex AI. Once the images are converted into embeddings, these vectors are stored in NeonDB, it is a database that supports vector search using PGVector extension.\n\nWhen a user uploads and image and performs similarity search using the app. The following process happens\n\n1. Conversion of request images into embeddings. Now again machine cannot understand the image, the image is processed and converting into vectors.\n2. Now once the images are converted into vectors, NeonDB performs a similarity search using its PGVector extension.\n3. The similarity search returns a list of images from the database that are most similar to the uploaded image. These results are ranked based on their similarity scores. (The similarity search is performed using cosine distance)\n4. The results are then sent back to the UI and are displayed.\n\n## Installation\n\nBefore we began with the installation make sure you're logged in, in the [Google Cloud CLI](https://cloud.google.com/docs/authentication/gcloud#gcloud-credentials).\n\n1. Clone the repo\n\n```bash\ngit clone https://github.com/ItzCrazyKns/Neon-Image-Search.git\n```\n\n2. Install dependencies\n\n```bash\nyarn\n```\n\nOr if you are using NPM\n\n```bash\nnpm i\n```\n\n3. Change the name of `.example.env.local` to `.env.local` and fill all the fields.\n\n4. Convert data images into embeddings. (The data images are stored in `/public/flower_images`)\n\n```bash\nyarn run generate-embeddings\n```\n\nOr if you are using NPM\n\n```bash\nnpm run generate-embeddings\n```\n\n5. Then finally started the app\n\n```bash\nyarn run dev\n```\n\nOr if you are using NPM\n\n```bash\nnpm run dev\n```\n\n**Note**: You can build the project then also use it by following NextJS's guidelines.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitzcrazykns%2Fneon-image-search","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fitzcrazykns%2Fneon-image-search","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitzcrazykns%2Fneon-image-search/lists"}