stau.space
Nix flakes on the AT protocol
docs: update README.md
author
Sona Tau Estrada Rivera
date
(Jul 26, 2026, 3:42 PM -0400)
commit
1b198423
1b198423f6c5d028d351bd01f370e6d89a6d175d
parent
6b484c6f
6b484c6f7e0ba01b0db240b2c920903f42ebbadc
+8
-2
+8
-2
README.md
+8
-2
README.md
···
4
4
5
5
The idea for this project originally started with wanting to have nix flakes be entirely inside AT protocol infrastructure.[^1] Your flake's metadata lives inside your own repo on your PDS as a record of the following lexicon: [`space.stau.nix.release`](at://did:plc:6n2ngs7zpcpwxz3jaoxj56tu/com.atproto.lexicon.schema/space.stau.nix.release).
6
6
7
+
## Status
8
+
9
+
Currently, Nix infrastructure is missing a fetcher that is able to resolve AT URIs. This is not surprising considering they have not had any use to do this before. A fetcher is needed in order to be able to declare an AT URI as an input for a flake.
10
+
11
+
As of now, you can publish flakes to your repo and you can build flakes directly from an AT URI. The closest you can get to being able to use an AT URI to fetch a git input would be to resolve the AT URI, getting the `source` and `rev` from your repo and putting that together in order to create a URL that Nix accepts and is able to fetch.
12
+
7
13
## Usage
8
14
9
15
```sh
···
11
17
nixat publish path/to/flake/ v3.1.4
12
18
```
13
19
14
-
---
20
+
## Building
15
21
16
-
[^1]: This is technically not possible. The closest one can get is similar to what Tangled does: [knots](https://tangled.org/tangled.org/core/blob/76c5ddbbfcaadad93af42530d706cf0aaea52b82/docs/knot-hosting.md). This means that the source code for the flake lives inside a knot while the rest of the project lives inside your actual PDS.
22
+
[^1]: This is technically, but not feasible long-term. You can upload blobs of source code to your PDS, but these blobs are usually capped by a max size. The closest one can get to emulating this is similar to what Tangled does: [knots](https://tangled.org/tangled.org/core/blob/76c5ddbbfcaadad93af42530d706cf0aaea52b82/docs/knot-hosting.md). This means that the source code for the flake lives inside a knot while the rest of the project lives inside your actual PDS.