diff --git a/docs/docs/features/img/advanced-search-filters.webp b/docs/docs/features/img/advanced-search-filters.webp new file mode 100644 index 0000000000..822d84faec Binary files /dev/null and b/docs/docs/features/img/advanced-search-filters.webp differ diff --git a/docs/docs/features/img/moblie-smart-serach.webp b/docs/docs/features/img/moblie-smart-serach.webp new file mode 100644 index 0000000000..e125fa5c62 Binary files /dev/null and b/docs/docs/features/img/moblie-smart-serach.webp differ diff --git a/docs/docs/features/img/search-ex-1.png b/docs/docs/features/img/search-ex-1.png new file mode 100644 index 0000000000..fa943d31b1 Binary files /dev/null and b/docs/docs/features/img/search-ex-1.png differ diff --git a/docs/docs/features/img/search-ex-2.webp b/docs/docs/features/img/search-ex-2.webp deleted file mode 100644 index c33285bc67..0000000000 Binary files a/docs/docs/features/img/search-ex-2.webp and /dev/null differ diff --git a/docs/docs/features/img/search-ex-3.webp b/docs/docs/features/img/search-ex-3.webp deleted file mode 100644 index 6c5e0bfb78..0000000000 Binary files a/docs/docs/features/img/search-ex-3.webp and /dev/null differ diff --git a/docs/docs/features/reverse-geocoding.md b/docs/docs/features/reverse-geocoding.md index 84045c17b0..108a6ea1b1 100644 --- a/docs/docs/features/reverse-geocoding.md +++ b/docs/docs/features/reverse-geocoding.md @@ -8,7 +8,7 @@ During Exif Extraction, assets with latitudes and longitudes are reverse geocode ## Usage -Data from a reverse geocode is displayed in the image details, and used in [Search](/docs/features/search.md). +Data from a reverse geocode is displayed in the image details, and used in [Smart Search](/docs/features/smart-search.md). diff --git a/docs/docs/features/search.md b/docs/docs/features/search.md deleted file mode 100644 index 0805007e54..0000000000 --- a/docs/docs/features/search.md +++ /dev/null @@ -1,14 +0,0 @@ -# Search - -Immich uses Postgres as its search database for both metadata and smart search. - -Smart search is powered by the [pgvecto.rs](https://github.com/tensorchord/pgvecto.rs) extension, utilizing machine learning models like CLIP to provide relevant search results. This allows for freeform searches without requiring specific keywords in the image or video metadata. - -Metadata search (prefixed with `m:`) can search specifically by text without the use of a model. - -Archived photos are not included in search results by default. To include them, add the query parameter `withArchived=true` to the url. - -Some search examples: - - - diff --git a/docs/docs/features/smart-search.md b/docs/docs/features/smart-search.md new file mode 100644 index 0000000000..65c71a4e80 --- /dev/null +++ b/docs/docs/features/smart-search.md @@ -0,0 +1,49 @@ +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# Smart Search + +Immich uses Postgres as its search database for both metadata and smart search. + +Smart search is powered by the [pgvecto.rs](https://github.com/tensorchord/pgvecto.rs) extension, utilizing machine learning models like [CLIP](https://openai.com/research/clip) to provide relevant search results. This allows for freeform searches without requiring specific keywords in the image or video metadata. + +Archived photos are not included in search results by default. To include them, mark the checkbox in [advanced search filters](/docs/features/smart-search#advanced-search-filters). + +:::tip Alternative CLIP Models +More powerful models can be used for more accurate search results. For more information, see the related [FAQ](/docs/FAQ#can-i-use-a-custom-clip-model). +::: + +:::info +Smart Search is currently limited to 5,000 results for a single search on the web. +::: + +## Advanced Search Filters + +In addition, Immich offers advanced search functionality, allowing you to find specific content using customizable search filters. These filters include location, one or more faces, specific albums, and more. You can try out the search filters on the [Demo site](https://demo.immich.app). + +Smart search features include: + +- Search for one or more faces (with or without context search). +- Search by Country or State or City or by all three. +- Search by camera make and model. +- Search by date range. +- Search by file name. +- Search by media types: image, video or all (**Note:** Image includes live images). +- Search by condition: not in any album or archive or Favorite or all conditions. + + + + +Some search examples: + + + + + + + + + + + + diff --git a/docs/static/_redirects b/docs/static/_redirects index 5f2d5c5a12..67c0ea2251 100644 --- a/docs/static/_redirects +++ b/docs/static/_redirects @@ -25,3 +25,4 @@ /docs/developer/contributing /docs/developer/pr-checklist 301 /docs/guides/machine-learning /docs/guides/remote-machine-learning 301 /docs/administration/password-login /docs/administration/system-settings 301 +/docs/features/search /docs/features/smart-search 301