bac545e23c
* release/next-vere: (1369 commits) nix: fixes `shellFor` nix-shell helper vere: print error and exit if stdin is not a tty build: silence service account activation output build: minor refactoring of haskell-nix overlays build: move darwin install_name_tool fixup from vere to king haskell u3: fixes incorrect double ref-counting in |ff jets u3: removes unused `Exit` variable u3: removes obsolete bail:need assertion u3: refactors fatal exception handling in u3m_bail() build: remove {sha256,md5} output for push-storage-object effects build: add log message when destination object already exists build: force google-cloud-sdk to use python3 build: adding support for hercules ci effects build: remove push-to-storage for ivory, brass, and solid pills pill: rebuild solid pill with %lens included in lite boot apps arvo: run %lens when lite boot (-l) is specified build: expose configurable arguments when booting/testing fake ships build: ensure urbit tests are run with the -g argument vere: ensure debug symbols aren't stripped by default (by nix) build: remove from-scratch ropsten pill builds on ci ... |
||
---|---|---|
.. | ||
app | ||
gen | ||
lib | ||
mar | ||
ren | ||
sur | ||
sys | ||
ted | ||
tests | ||
.gitattributes | ||
.ignore | ||
LICENSE.txt | ||
README.md | ||
TESTING.udon |
Arvo
A clean-slate operating system.
Usage
To run Arvo, you'll need Urbit. To install Urbit and run Arvo please follow the instructions in the getting started docs. You'll be on the live network in a few minutes.
If you're doing development on Arvo, keep reading.
Documentation
Find Arvo's documentation on urbit.org.
Development
To boot a fake ship from your development files, run urbit
with the following arguments:
urbit -F zod -A /path/to/arvo -c fakezod
Mount Arvo's filesystem allows you to update its contents through Unix. To do so, run |mount
in dojo. It is most common to |mount /=home=
.
To create a custom pill (bootstrapping object) from the files loaded into the home desk, run .my/pill +solid
. Your pill will appear in /path/to/fakezod/.urb/put/my.pill
.
To boot a fake ship with a custom pill, use the -B
flag:
urbit -F zod -A /path/to/arvo -B /path/to.pill -c fakezod
To run all tests in /tests
, run -test %/tests
in dojo. To run only the tests in /tests/some/path
, use -test %/tests/some/path
.
Maintainers
Most parts of Arvo have dedicated maintainers.
/sys/hoon
: @pilfer-pandex (~pilfer-pandex)/sys/zuse
: @pilfer-pandex (~pilfer-pandex)/sys/arvo
: @joemfb (~master-morzod)/sys/vane/ames
: @belisarius222 (~rovnys-ricfer) & @philipcmonk (~wicdev-wisryt)/sys/vane/behn
: @belisarius222 (~rovnys-ricfer)/sys/vane/clay
: @philipcmonk (~wicdev-wisryt) & @belisarius222 (~rovnys-ricfer)/sys/vane/dill
: @joemfb (~master-morzod)/sys/vane/eyre
: @eglaysher (~littel-ponnys)/sys/vane/gall
: @philipcmonk (~wicdev-wisryt)/sys/vane/jael
: @fang- (~palfun-foslup) & @philipcmonk (~wicdev-wisryt)/app/acme
: @joemfb (~master-morzod)/app/dns
: @joemfb (~master-morzod)/app/aqua
: @philipcmonk (~wicdev-wisryt)/app/hood
: @belisarius222 (~rovnys-ricfer)/lib/hood/drum
: @philipcmonk (~wicdev-wisryt)/lib/hood/kiln
: @philipcmonk (~wicdev-wisryt)/lib/test
: @eglaysher (~littel-ponnys)
Contributing
Contributions of any form are more than welcome! Please take a look at our contributing guidelines for details on our git practices, coding styles, how we manage issues, and so on.
You might also be interested in:
- joining the urbit-dev mailing list.
- applying to Hoon School, a course we run to teach the Hoon programming language and Urbit application development.