A high-performance Haskell implementation of the Hentai@Home client. The client caches and serves gallery files, communicates with the H@H server via TLS-secured RPC, and supports S3-compatible storage backends including Cloudflare R2.

Resource caching uses an LRU cache with SQLite-backed or R2-backed storage. RPC communication to the H@H server uses TLS with automatic certificate refresh every 24 hours. Rate limiting includes both IP-based throttling and keystamp-based fallback for NAT environments. Gallery downloads support parallel file fetching. Prometheus metrics are available at the /metrics endpoint. The client tracks build information via the --version flag.

• Stack (Haskell toolchain)
• SQLite 3
• OpenSSL libraries

git clone https://github.com/pe200012/hs-hath.git
cd hs-hath
stack build

Create a client-login file with your credentials:

{ clientId = "your-client-id"
, key = "your-api-key" 
, version = "1.0.0"
, proxy = None ClientProxy
, downloadDir = "./downloads"
, cachePath = "./cache.db"
}

Start the client:

stack exec hs-hath

View version information:

stack exec hs-hath -- --version

The client responds to SIGINT and SIGTERM for graceful shutdown. Settings reload automatically via RPC command. The Prometheus metrics endpoint is available at /metrics for monitoring.

The RPC client handles communication with the H@H server, including certificate management and settings synchronization. The resource cache stores files using SQLite with LRU eviction. An HTTP server built on Warp serves cached resources. Rate limiting middleware provides both IP-based and keystamp-based request throttling. The storage backend supports local filesystem and S3-compatible services like Cloudflare R2.

The client exports Prometheus metrics in text format at the /metrics endpoint. Metrics include request counters, cache statistics, and operational counters for monitoring and alerting.

Has not been optimized yet. Currently, it will take ~200MiB RAM on average.

Verify system clock synchronization and certificate file permissions. Certificate refresh occurs automatically every 24 hours.

Check proxy settings if configured. Ensure firewall allows outbound TLS connections on the required ports.

For S3-compatible backends like Cloudflare R2, verify that the storage server returns required headers: ETag, Content-Length, and Last-Modified. Missing ETag headers cause write failures.

The client implements strict request throttling. Banned IPs and rate limit violations appear in console logs. Verify client configuration if legitimate requests are being rejected.

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.