hydrus

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.

22 articles 3k View on GitHub ↗
22 articles
How Hydrus Networking Sessions 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.

internals
Mar 3, 2026
How Hydrus Persists and Loads Configuration Using Its Serializable Data System

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.

internals
Mar 3, 2026
How Hydrus Implements a 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.

internals
Mar 3, 2026
How Hydrus Client-Server Networking Handles 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.

internals
Mar 3, 2026
How the Hydrus Metadata Migration Exporter/Importer System Works

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.

internals
Mar 3, 2026
How the Hydrus URL Mapping System Associates 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.

internals
Mar 3, 2026
How the Hydrus Content Update System Batches and Processes Tag Changes

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

internals
Mar 3, 2026
How Media Results Caching Improves Search Performance in Hydrus

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

performance
Mar 3, 2026
How the Hydrus Tag Search System Optimizes 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.

internals
Mar 3, 2026
How Hydrus Manages Physical File Storage Locations: A Deep Dive into Hash-Based Directory Trees

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

deep-dive
Mar 3, 2026
Hydrus Service System Architecture: Local Repository Server Design

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.

architecture
Mar 3, 2026
How the Hydrus Maintenance Daemon Schedules and Executes 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.

internals
Mar 3, 2026

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:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"
Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →