c5394b775f
* release/next-vere: (57 commits) u3: initializes head/tail in u3i_defcons() (under U3_MEMORY_DEBUG) king: actually try shutting down the piers king: --serf="" is a host option, not a per ship option. u3: optimizes +wyt:in jet, gated by compile-time assertion u3: further optimizes +lent jet, gated by compile-time assertion u3: refactors allocator constants, adds u3a_cells and u3a_maximum u3: optimizes +lent jet, avoiding u3i_vint() while possible u3: moves cell allocation counter into u3a_celloc() u3: fixes memory leak introduced in +murn jet u3: fixes mismatches in +div and +dvr jets u3: fixes memory leaks in +dvr and +sqt jets u3: rewrites +flop jet using new list iteration idiom u3: rewrites +weld jet using u3i_defcons() u3: rewrites +scag jet using u3i_defcons() u3: rewrites +murn jet using u3i_defcons() u3: rewrites +turn jet using u3i_defcons() u3: adds u3i_defcons(), deferred cell constructor vere: add missing function comment vere: use h2o functions for finding cookie header vere: put runtime http bindings under /~_~ ... |
||
---|---|---|
.github/ISSUE_TEMPLATE | ||
bin | ||
doc/spec | ||
extras | ||
nix | ||
pkg | ||
sh | ||
.gitattributes | ||
.gitignore | ||
.ignore | ||
.mailmap | ||
.stylish-haskell.yaml | ||
.travis.yml | ||
CONTRIBUTING.md | ||
default.nix | ||
LICENSE.txt | ||
MAINTAINERS.md | ||
Makefile | ||
README.md |
Urbit
Urbit is a personal server stack built from scratch. It has an identity layer (Azimuth), virtual machine (Vere), and operating system (Arvo).
A running Urbit "ship" is designed to operate with other ships peer-to-peer. Urbit is a general-purpose, peer-to-peer computer and network.
This repository contains:
- The Arvo OS
- herb, a tool for Unix control of an Urbit ship
- Source code for Landscape's web interface
- Source code for the vere virtual machine.
For more on the identity layer, see Azimuth. To manage your Urbit identity, use Bridge.
Install
To install and run Urbit, please follow the instructions at urbit.org/using/install. You'll be on the live network in a few minutes.
If you're interested in Urbit development, keep reading.
Development
Urbit uses Nix to manage builds. On Linux and macOS you can install Nix via:
curl -L https://nixos.org/nix/install | sh
The Makefile in the project's root directory contains useful phony targets for building, installing, testing, and so on. You can use it to avoid dealing with Nix explicitly.
To build the Urbit virtual machine binary, for example, use:
make build
The test suite can similarly be run via a simple:
make test
Note that some of the Makefile targets need access to pills tracked via git LFS, so you'll also need to have those available locally:
git lfs install
git lfs pull
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.
For instructions on contributing to Landscape, see its guidelines.
You might also be interested in joining the urbit-dev mailing list.