# hydrus | Hydrus Network Developer | Knowledge Base | Instagit

A personal booru-style media tagger that can import files and tags from your hard drive and popular websites. Content can be shared with other users via user-run servers.

GitHub Stars: 3k

Repository: https://github.com/hydrusnetwork/hydrus

---

## Articles

### [How Hydrus Networking Sessions Handle Cookies and Authentication](/hydrusnetwork/hydrus/how-does-the-networking-sessions-system-handle-cookies-and-authentication)

Discover how Hydrus networking sessions manage cookies and authentication using access keys and session cookies for secure, persistent connections. Learn about client-side cleanup and server account resolution.

- Tags: internals
- Published: 2026-03-03

### [How Hydrus Persists and Loads Configuration Using Its Serializable Data System](/hydrusnetwork/hydrus/how-does-the-serializable-data-system-persist-and-load-configuration)

Discover how Hydrus uses its serializable data system to persist and load configuration via JSON objects and SQLite tuples. Learn about versioned data and type ID mapping.

- Tags: internals
- Published: 2026-03-03

### [How Hydrus Implements a Threading Model for Background Tasks and UI Responsiveness](/hydrusnetwork/hydrus/what-is-the-threading-model-for-background-tasks-and-ui-responsiveness)

Discover how Hydrus manages background tasks and UI responsiveness using dedicated Python threads, daemons, and a job scheduler to ensure smooth operation and prevent overload.

- Tags: internals
- Published: 2026-03-03

### [How Hydrus Client-Server Networking Handles HTTP/HTTPS Requests](/hydrusnetwork/hydrus/how-does-the-client-server-networking-handle-http-https-requests)

Discover how Hydrus client-server networking manages HTTP/HTTPS requests using Python requests and Twisted. Understand its dual-layer architecture for efficient API handling.

- Tags: internals
- Published: 2026-03-03

### [How the Hydrus Metadata Migration Exporter/Importer System Works](/hydrusnetwork/hydrus/how-does-the-metadata-migration-exporter-importer-system-work)

Explore the Hydrus metadata migration exporter importer system. Understand its modular node-based architecture for seamless bidirectional metadata transfer between media files and side-car files.

- Tags: internals
- Published: 2026-03-03

### [How the Hydrus URL Mapping System Associates URLs with Files](/hydrusnetwork/hydrus/how-does-the-url-mapping-system-associate-urls-with-files)

Discover how the Hydrus URL mapping system associates URLs with files using hash IDs and an SQLite table. Learn about this core feature of the Hydrus network repository.

- Tags: internals
- Published: 2026-03-03

### [How the Hydrus Content Update System Batches and Processes Tag Changes](/hydrusnetwork/hydrus/how-does-the-content-update-system-batch-and-process-tag-changes)

Learn how Hydrus batches and processes tag changes efficiently. Discover how ContentUpdate objects and packages minimize database trips for faster synchronization.

- Tags: internals
- Published: 2026-03-03

### [How Media Results Caching Improves Search Performance in Hydrus](/hydrusnetwork/hydrus/how-does-the-media-results-caching-improve-search-performance)

Discover how Hydrus caching dramatically speeds up searches. Learn how media results caching uses in-memory storage to eliminate redundant queries and boost performance.

- Tags: performance
- Published: 2026-03-03

### [How the Hydrus Tag Search System Optimizes Queries with Caching](/hydrusnetwork/hydrus/how-does-the-tag-search-system-optimize-queries-with-caching)

Discover how Hydrus optimizes tag searches with four specialized SQLite caches. Learn how pre-computed sub-tags and wildcard expansions boost performance and eliminate slow table scans.

- Tags: internals
- Published: 2026-03-03

### [How Hydrus Manages Physical File Storage Locations: A Deep Dive into Hash-Based Directory Trees](/hydrusnetwork/hydrus/how-does-the-physical-file-storage-system-manage-file-locations)

Learn how Hydrus manages physical file storage with hash-based directory trees. Explore deterministic folder generation and file distribution across storage locations.

- Tags: deep-dive
- Published: 2026-03-03

### [Hydrus Service System Architecture: Local Repository Server Design](/hydrusnetwork/hydrus/what-is-the-architecture-of-the-service-system-local-repository-server)

Explore the Hydrus service system architecture. Learn how the local repository server design uses Twisted HTTP/HTTPS, a ServerController, SQLite, and networking for administration and data management.

- Tags: architecture
- Published: 2026-03-03

### [How the Hydrus Maintenance Daemon Schedules and Executes Background Tasks](/hydrusnetwork/hydrus/how-does-the-maintenance-daemon-schedule-and-execute-background-tasks)

Learn how the Hydrus maintenance daemon schedules and executes background tasks using CallRepeating, ManagerWithMainLoop, and clean thread stopping for efficient operations. Optimize your Hydra network.

- Tags: internals
- Published: 2026-03-03

### [How Hydrus Throttles Network Requests: A Deep Dive into Its Bandwidth Management System](/hydrusnetwork/hydrus/how-does-the-bandwidth-management-system-throttle-network-requests)

Discover how Hydrus throttles network requests using its two-layer bandwidth control system combining usage tracking and policy enforcement for efficient bandwidth management across five time granularities.

- Tags: deep-dive
- Published: 2026-03-03

### [How Hydrus Visual Duplicate Detection Works: A Deep Dive into the Duplicate Comparison Algorithm](/hydrusnetwork/hydrus/how-does-the-duplicate-comparison-algorithm-determine-visual-similarity)

Discover how Hydrus's duplicate comparison algorithm visually identifies similar images using a six-stage pipeline including color histogram and edge-map analysis.

- Tags: deep-dive
- Published: 2026-03-03

### [How the Hydrus Tag Repository Sync Protocol Works for Sharing Tags](/hydrusnetwork/hydrus/how-does-the-repository-sync-protocol-work-for-sharing-tags)

Learn how the Hydrus tag repository sync protocol mirrors tag data. Discover efficient offline searches with this pull-based system for seamless tag sharing.

- Tags: internals
- Published: 2026-03-03

### [How to Migrate Tags Between Services in Hydrus: Complete Technical Guide](/hydrusnetwork/hydrus/how-does-the-tag-migration-system-work-for-moving-tags-between-services)

Learn how the Hydrus tag migration system efficiently moves tags between services with its three layer architecture. Stream data without memory issues.

- Tags: how-to-guide
- Published: 2026-03-03

### [How Hydrus Handles Duplicates and File Seeds in the File Import System](/hydrusnetwork/hydrus/how-does-the-file-import-system-handle-duplicates-and-file-seeds)

Learn how Hydrus prevents redundant downloads and synchronizes metadata with its advanced file import system, featuring FileSeeds and DuplicateContentMergeOptions.

- Tags: internals
- Published: 2026-03-03

### [How the Hydrus Subscription Query System Schedules Periodic Downloads](/hydrusnetwork/hydrus/how-does-the-subscription-query-system-work-and-schedule-periodic-downloads)

Discover how the Hydrus subscription query system schedules periodic downloads by self-scheduling queries based on bandwidth, domain health, and file status. Learn how sync jobs launch.

- Tags: internals
- Published: 2026-03-03

### [How Hydrus Custom Downloaders Parse and Extract Tags from Websites](/hydrusnetwork/hydrus/how-do-custom-downloaders-parse-and-extract-tags-from-websites)

Learn how Hydrus custom downloaders parse HTML using ParseFormulaHTML and ParseRuleHTML to extract and validate website tags with namespaces for efficient content management.

- Tags: how-to-guide
- Published: 2026-03-03

### [SQLite Database Schema Structure for Files and Mappings in Hydrus](/hydrusnetwork/hydrus/what-is-the-sqlite-database-schema-structure-for-files-and-mappings)

Explore the Hydrus SQLite database schema structure for files and mappings. Understand its dual-layer architecture for efficient metadata and state tracking.

- Tags: internals
- Published: 2026-03-03

### [How Hydrus Client API Authentication and Access Key System Works](/hydrusnetwork/hydrus/how-does-the-client-api-authentication-and-access-key-system-work)

Understand Hydrus Client API authentication. Learn how the registration key, access key, and session key system uses short-lived cookies to protect secrets during active requests.

- Tags: internals
- Published: 2026-03-03

### [How the Hydrus Tag Sibling and Parent System Works: Complete Database Architecture](/hydrusnetwork/hydrus/how-does-the-tag-sibling-and-parent-system-work-in-the-database)

Explore the Hydrus tag sibling and parent system's database architecture. Learn how cycle-safe in-memory structures, persistent SQLite tables, and regenerated caches manage bidirectional tag replacements and hierarchical relati...

- Tags: architecture
- Published: 2026-03-03