feat: add Nix flake support

.gitignore

@@ -13,3 +13,5 @@ snapshot_report.html
 # Virtual environments
 .venv
 venv_fix/
+result
+result-*

docs/installation.md

@@ -34,6 +34,28 @@ yay -S torrra-bin
 
 > `torrra-bin` includes a precompiled standalone binary specifically for x86_64 Linux systems.
 
+## Nix / NixOS
+
+`torrra` is available on Nix and NixOS through a Nix flake.
+
+### Run directly without installing
+
+```sh
+nix run github:stabldev/torrra
+```
+
+### Or add to your NixOS configuration
+
+```nix
+# In flake.nix inputs:
+torrra.url = "github:stabldev/torrra";
+
+# In your NixOS configuration:
+environment.systemPackages = [ inputs.torrra.packages.${pkgs.system}.default ];
+```
+
+> **Note:** This requires [Nix flakes](https://nixos.wiki/wiki/Flakes) to be enabled.
+
 ## Standalone Binaries (No Python Required)
 
 You can download pre-built executables of `torrra` directly from the [GitHub Releases](https://github.com/stabldev/torrra/releases) page. These binaries do not require Python to be installed on your system.

flake.nix

@@ -0,0 +1,33 @@
+{
+  description = "Nix flake for torrra - Search and download torrents from the CLI";
+
+  inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
+
+  outputs = { self, nixpkgs }:
+    let
+      version = "2.0.7";
+      systems = [ "x86_64-linux" "aarch64-linux" "x86_64-darwin" "aarch64-darwin" ];
+      forEachSystem = f: nixpkgs.lib.genAttrs systems (system:
+        f nixpkgs.legacyPackages.${system}
+      );
+    in
+    {
+      packages = forEachSystem (pkgs: rec {
+        torrra = pkgs.callPackage ./package.nix { src = self; inherit version; };
+        default = torrra;
+      });
+
+      overlays.default = final: _prev: {
+        torrra = final.callPackage ./package.nix { src = self; inherit version; };
+      };
+
+      nixosModules.default = { lib, pkgs, config, ... }: {
+        options.programs.torrra.enable = lib.mkEnableOption "torrra torrent CLI";
+
+        config = lib.mkIf config.programs.torrra.enable {
+          nixpkgs.overlays = [ self.overlays.default ];
+          environment.systemPackages = [ pkgs.torrra ];
+        };
+      };
+    };
+}

package.nix

@@ -0,0 +1,42 @@
+{ lib
+, python3Packages
+, src
+, version
+}:
+
+python3Packages.buildPythonApplication {
+  pname = "torrra";
+  inherit version src;
+
+  pyproject = true;
+
+  build-system = with python3Packages; [ hatchling ];
+
+  nativeBuildInputs = with python3Packages; [ pythonRelaxDepsHook ];
+
+  # pyproject.toml lists "libtorrent" (provided by nixpkgs as libtorrent-rasterbar,
+  # different name) and "libtorrent-windows-dll" (Windows-only, irrelevant here).
+  # Remove both so the runtime deps check doesn't fail;
+  # libtorrent-rasterbar is still injected via dependencies below.
+  pythonRemoveDeps = [ "libtorrent" "libtorrent-windows-dll" ];
+
+  dependencies = with python3Packages; [
+    libtorrent-rasterbar
+    textual
+    httpx
+    click
+    diskcache
+    platformdirs
+    tomli-w
+  ];
+
+  pythonImportsCheck = [ "torrra" ];
+
+  meta = {
+    description = "Search and download torrents from the CLI, powered by Jackett/Prowlarr and Libtorrent";
+    homepage = "https://github.com/stabldev/torrra";
+    license = lib.licenses.mit;
+    mainProgram = "torrra";
+    platforms = lib.platforms.unix;
+  };
+}