# soruly/trace.moe

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/soruly-trace-moe).**

4,992 stars · 260 forks · MIT

## Links

- GitHub: https://github.com/soruly/trace.moe
- Homepage: https://trace.moe
- awesome-repositories: https://awesome-repositories.com/repository/soruly-trace-moe.md

## Topics

`anime` `image-search` `milvus` `search-engine`

## Description

This project is an anime scene reverse image search engine that matches a screenshot to the exact anime episode and timestamp. It is designed as a self-hosted search service that can be deployed using Docker containers and pre-indexed databases, enabling private operation on local or custom infrastructure.

At its core, the system extracts visual features from frames using a convolutional neural network trained on anime imagery. Query images provided via URL are processed through the same feature extraction pipeline, and an approximate nearest neighbor search matches the query against millions of precomputed frame features for sub-second results. The matched frame is then translated into the corresponding episode, offset, and scene metadata.

The service is delivered as a Docker Compose orchestration that configures multiple containers for the search, API, and database layers. A precomputed database dump is loaded on startup to initialize the search service without requiring full indexing. An API endpoint accepts an image URL as a query parameter and returns source information, including a sample clip.

## Tags

### Graphics & Multimedia

- [Anime Scene Recognition](https://awesome-repositories.com/f/graphics-multimedia/anime-scene-recognition.md) — A reverse image search engine that finds the exact anime scene from a screenshot or image URL.
- [Screenshot Matchers](https://awesome-repositories.com/f/graphics-multimedia/anime-scene-recognition/screenshot-matchers.md) — Match an uploaded screenshot to the exact video, episode, and timestamp in an anime scene search database. ([source](https://trace.moe/))
- [Visual Feature Embeddings](https://awesome-repositories.com/f/graphics-multimedia/visual-feature-embeddings.md) — Extracts visual features from frames using a convolutional neural network trained on anime imagery.
- [Anime Frame Matchers](https://awesome-repositories.com/f/graphics-multimedia/video-frame-processing/anime-frame-matchers.md) — A tool that matches uploaded screenshots to specific video frames, returning episode and timestamp.

### Data & Databases

- [Approximate Nearest Neighbor Search](https://awesome-repositories.com/f/data-databases/approximate-nearest-neighbor-search.md) — Matches query features against millions of precomputed frame features using a vector index for sub-second results.
- [Precomputed Data Imports](https://awesome-repositories.com/f/data-databases/data-aggregation-pipelines/precomputation-engines/precomputed-data-imports.md) — Load a precomputed database dump to quickly initialize a self-hosted anime scene search instance without full processing. ([source](https://cdn.jsdelivr.net/gh/soruly/trace.moe@master/README.md))
- [Precomputed Database Dumps](https://awesome-repositories.com/f/data-databases/database-indexing/precomputed-database-dumps.md) — Loads a snapshot of frame features, metadata, and timestamps into the search service for instant readiness.
- [Frame Number Mappings](https://awesome-repositories.com/f/data-databases/pointer-based-navigation/offset-based-addressing/timestamp-based-offset-lookups/frame-number-mappings.md) — Translates matched frame numbers to exact anime episode, offset, and scene metadata.

### DevOps & Infrastructure

- [Docker Compose Deployments](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/container-runtimes/runtime-configuration-interfaces/docker-socket-orchestrators/docker-target-configurators/docker-container-deployments/docker-compose-deployments.md) — Deploy the anime scene search stack using Docker Compose on local or custom infrastructure for self-hosted operation. ([source](https://cdn.jsdelivr.net/gh/soruly/trace.moe@master/README.md))
- [Anime Scene Search Services](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/container-runtimes/runtime-configuration-interfaces/docker-socket-orchestrators/docker-target-configurators/docker-container-deployments/docker-compose-deployments/anime-scene-search-services.md) — A search service for anime that can be self-hosted via Docker containers and pre-indexed databases.
- [Self-Hosted Search Services](https://awesome-repositories.com/f/devops-infrastructure/self-hosted-search-services.md) — A deployable search system for anime scene identification using Docker Compose and precomputed data.

### Web Development

- [URL-Based Image Queries](https://awesome-repositories.com/f/web-development/url-based-image-queries.md) — Providing an image URL as a query parameter to identify the anime scene without uploading a file.