golusoris

Foundational Go libraries and the applications built on top of them

The central framework modules, service clients, and self-hosted apps of the golusoris ecosystem

golusoris provides foundational Go libraries and the suite of applications built on top of them. It encompasses composable framework modules covering core backend infrastructure using Uber's fx dependency-injection framework, zero-dependency typed clients for media automation and metadata services, and self-hosted applications built on both, listed under Apps.

• golusoris/golusoris — the framework: composable fx modules covering config, logging, errors, database, HTTP, OTel, jobs, cache, auth, k8s runtime, notifications, storage, AI, and more.
• golusoris/goenvoy — typed clients for the *arr stack, metadata services (TMDB, AniList, Trakt, …), and download/indexer APIs. 60+ zero-dependency modules.

All apps are built on the golusoris framework. Their repositories are not published yet; each will use the app- prefix here:

• app-revenge — high-performance Go media server
• app-lurkarr — automated media hunting for *arr apps
• app-subdo — visual flow editor for media processing automation
• app-arca — self-hosted ROM management platform

The namesake repo golusoris/golusoris is the framework itself.

Start with CONTRIBUTING.md for contribution guidelines, signing expectations, and Conventional Commits conventions. Report vulnerabilities privately as described in SECURITY.md.

golusoris is free and open source. Support ongoing development, maintenance, and infrastructure costs:

• GitHub Sponsors (sponsors/lusoris)
• Ko-fi (lusoris)

Code and workflows in this repository are licensed under the European Union Public Licence v. 1.2 (EUPL-1.2). Markdown prose and documentation files are licensed under Creative Commons Attribution-ShareAlike 4.0 International (CC-BY-SA-4.0) per REUSE.toml.

The golusoris/.github repository declares the 21 invariants of the High-Integrity Systems Standard (HISS) from Praetor in AGENTS.md. Its table names the check that enforces each invariant and marks the invariants that are advisory only. Pull request titles follow Conventional Commits. Every commit carries a cryptographic signature (git commit -S) and, separately, a Signed-off-by trailer (git commit -s), as CONTRIBUTING.md describes.