document usage/status
tvix sounds pretty cool. as such, as a user of nixos + home-manager, i would be interested to learn how to use it. however, currently the tvix readme leaves this topic undocumented, including questions such as:
- how do i install this? (no flakes seem exposed, and tvix does not appear packaged in nixpkgs)
- is it possible to use this project thru nixos-rebuild / home-manager so as to make use of the performance gains there?
- what is the status of this project? are the above questions not documented as the answers are deemed evident or is usage in such a way simply still deemed far off?
just realized the status questions seem largely answered in the second blog post
kiaragrouwstra at 2023-11-28T15·18+00
The second blog post is over a year out of date, we need to write a new one :)
There are two more recent updates, but in talk form:
- Tvix as a whole, flokli's talk from NixCon: https://media.ccc.de/v/nixcon-2023-35254-tvix
- more focus on tvix-eval internals, my talk at a Rust meetup (in Russian): https://tazj.in/blog/tvix-eval-talk-2023
We haven't focused much on user-facing documentation yet, as we have specific goals for first usage in mind which are not initially "somebody using Tvix as a drop-in for their personal NixOS machines (this probably answers you rsecond question), and most people using the codebase in some form are its developers. Definitely something we need to improve, though :)
how do i install this?
You can clone either our entire repo, and build the components you're interested in using
nix-build(e.g.nix-build -A tvix.cli), or you can clone only the Tvix subtree (git clone https://code.tvl.fyi/depot.git:workspace=views/tvix.git) and build it with standard Rust tooling.
I'll keep this ticket around for user-facing documentation improvements.
tazjin at 2023-11-28T15·31+00