1 files changed, 51 insertions, 0 deletions
diff --git a/cuda/nix-python-devenv/README.md b/cuda/nix-python-devenv/README.md
new file mode 100644
index 0000000..df1ef33
--- /dev/null
+++ b/cuda/nix-python-devenv/README.md
@@ -0,0 +1,51 @@
+# Nix Python Devenv
+
+A Python development environment template using [devenv](https://devenv.sh) with working C bindings,
+managed by [uv](https://docs.astral.sh/uv/) package manager.
+
+A version of this repo with CUDA is available on the
+[cuda branch](https://github.com/clementpoiret/nix-python-devenv/tree/cuda).
+
+## Features
+
+- CUDA toolkit and CUDNN support (see the `cuda` branch)
+- Python 3.x environment
+- Fast package management with uv
+- Automatic environment activation with direnv
+- Example script using numpy
+
+## Installation
+
+1. Install [Nix](https://nixos.org/download/):
+   ```bash
+   sh <(curl -L https://nixos.org/nix/install) --daemon
+   ```
+
+2. Install [devenv](https://devenv.sh/)
+   ```bash
+   nix-env -iA devenv -f https://github.com/NixOS/nixpkgs/tarball/nixpkgs-unstable
+   ```
+
+3. Install [direnv](https://direnv.net/) (optional but recommended)
+
+4. Clone and setup:
+   ```bash
+   git clone --single-branch --branch cuda git@github.com:clementpoiret/nix-python-devenv.git
+
+   # Allow direnv to manage the environment
+   direnv allow
+   ```
+
+## Usage
+
+The environment automatically:
+- Activates the Python virtual environment
+- Sets up LD_LIBRARY_PATH
+- Provides the `hello` command to test C Bindings
+
+Run the sample script:
+```bash
+hello
+```
+
+This will display the output of numpy functions.