Documentation

Everything you need to use Zorbs.

Quick Start

Zorbs is the official package registry for the Zeta programming language. Find, publish, and distribute Zeta packages with the zorb CLI tool.

Installing Zeta

Install the Zeta compiler (includes the zorb CLI) with one command:

curl -sSf https://raw.githubusercontent.com/murphsicles/zippy/main/install.sh | sh

Or manually from GitHub Releases:

# Download the latest release
wget https://github.com/murphsicles/zeta/releases/download/v1.0.18/zetac-linux-x64
chmod +x zetac-linux-x64
sudo mv zetac-linux-x64 /usr/local/bin/zetac

# Verify
zetac --version

The zorb package manager is built into zetac:

zetac --zorb help

Finding Packages

Browse all available packages at zorbs.io/discover or search from the command line:

zorb search tokio
zorb search serde
zorb search crypto

Adding a Package to Your Project

Add a dependency to your zorb.toml:

zorb add @async/tokio
zorb add @data/serde --vers 1.0

Or manually edit your zorb.toml:

[dependencies]
@async/tokio = "0.3"
@data/serde = "1.0"

Publishing a Package

Sign in to Zorbs (via GitHub, Google, X, or Passkey), then publish:

zorb publish

You can also publish via the web interface at zorbs.io/publish.

Your package needs a valid zorb.toml with at least a name and version field.

Package Names & Scoping

Zorbs uses scoped package names following the convention:

@namespace/package-name

Scoped names help organize packages by category and prevent naming conflicts. Both the namespace and package name are case-insensitive.

Reserved Namespaces

The following namespaces are reserved for official Zeta Foundation packages, maintained by the Dark Factory. Each namespace hosts packages in the corresponding GitHub repository.

Package GitHub
@accounting/ledgermurphsicles/ledger
@alloc/arenamurphsicles/arena
@async/futuresmurphsicles/futures
@async/futures-coremurphsicles/futures-core
@async/futures-utilmurphsicles/futures-util
@async/tokiomurphsicles/tokio
@async/tokio-utilmurphsicles/tokio-util
@bitcoin/overlay-broadcastmurphsicles/overlay-broadcast
@bench/testiclesmurphsicles/testicles
@cli/clapmurphsicles/clap
@cli/clap_buildermurphsicles/clap_builder
@collections/hashbrownmurphsicles/hashbrown
@collections/indexmapmurphsicles/indexmap
@collections/smallvecmurphsicles/smallvec
@compress/zstdmurphsicles/zstd
@consensus/vsrmurphsicles/vsr
@core/once_cellmurphsicles/once_cell
@crypto/bitcoin-hashesmurphsicles/bitcoin-hashes
@crypto/bsv58murphsicles/bsv58
@crypto/aes-gcmmurphsicles/aes-gcm
@crypto/argon2murphsicles/argon2
@crypto/hkdfmurphsicles/hkdf
@crypto/k256murphsicles/k256
@crypto/xxhashmurphsicles/xxhash
@crypto/sha2murphsicles/sha2
@crypto/subtlemurphsicles/subtle
@crypto/zeroizemurphsicles/zeroize
@crypto/murmur3murphsicles/murmur3
@crypto/nourmurphsicles/nour
@crypto/randmurphsicles/rand
@crypto/rand_coremurphsicles/rand_core
@crypto/ringmurphsicles/ring
@crypto/ripemdmurphsicles/ripemd
@crypto/secp256k1murphsicles/secp256k1
@crypto/ztlsmurphsicles/ztls
@data/hexmurphsicles/hex
@data/linked-hash-mapmurphsicles/linked-hash-map
@data/serdemurphsicles/serde
@data/snowflakemurphsicles/snowflake
@db/zenithmurphsicles/zenith
@db/zsqlmurphsicles/zsql
@db/capybaramurphsicles/CapybaraDB
@encoding/base64murphsicles/base64
@encoding/bincodemurphsicles/bincode
@encoding/csvmurphsicles/csv
@encoding/serde_jsonmurphsicles/serde_json
@encoding/tomlmurphsicles/toml
@ffi/libcmurphsicles/libc
@fs/walkdirmurphsicles/walkdir
@http/axummurphsicles/axum
@io/byteordermurphsicles/byteorder
@io/flate2murphsicles/flate2
@io/uringmurphsicles/uring
@log/tracingmurphsicles/tracing
@log/tracing-subscribermurphsicles/tracing-subscriber
@logging/env-loggermurphsicles/env-logger
@math/num-bigintmurphsicles/num-bigint
@math/num-traitsmurphsicles/num-traits
@math/num-bigint-digmurphsicles/num-bigint-dig
@metrics/prometheusmurphsicles/prometheus
@net/dns-lookupmurphsicles/dns-lookup
@net/httpmurphsicles/http
@net/http-bodymurphsicles/http-body
@net/hypermurphsicles/hyper
@net/mimemurphsicles/mime
@net/reqwestmurphsicles/reqwest
@net/socket2murphsicles/socket2
@net/tcpmurphsicles/tcp
@net/towermurphsicles/tower
@net/urlmurphsicles/url
@net/tiny-httpmurphsicles/tiny-http
@net/ureqmurphsicles/ureq
@os/iomurphsicles/os-io
@overlay/apimurphsicles/api
@overlay/broadcastmurphsicles/broadcast
@overlay/bsvmurphsicles/bsv
@overlay/ciphermurphsicles/cipher
@overlay/ckdmurphsicles/ckd
@overlay/climurphsicles/cli
@overlay/custodymurphsicles/custody
@overlay/keygraphmurphsicles/keygraph
@overlay/kstmurphsicles/kst
@overlay/obsmurphsicles/obs
@overlay/overlaymurphsicles/overlay
@overlay/resmurphsicles/res
@overlay/secmemmurphsicles/secmem
@overlay/sessionmurphsicles/session
@parallel/rayonmurphsicles/rayon
@parallel/rayon-coremurphsicles/rayon-core
@parsing/nommurphsicles/nom
@proto/prostmurphsicles/prost
@serde/varintmurphsicles/varint
@std/anyhowmurphsicles/anyhow
@std/bitflagsmurphsicles/bitflags
@std/cfg-ifmurphsicles/cfg-if
@std/itertoolsmurphsicles/itertools
@std/lazy_staticmurphsicles/lazy_static
@std/logmurphsicles/log
@std/memchrmurphsicles/memchr
@std/thiserrormurphsicles/thiserror
@std/uuidmurphsicles/uuid
@stdlib/regexmurphsicles/regex
@stdlib/regex-automatamurphsicles/regex-automata
@stdlib/regex-syntaxmurphsicles/regex-syntax
@storage/lsmmurphsicles/lsm
@sync/crossbeammurphsicles/crossbeam
@sync/parking_lotmurphsicles/parking_lot
@sys/getrandommurphsicles/getrandom
@sys/signal-hookmurphsicles/signal-hook
@text/unicode-widthmurphsicles/unicode-width
@time/chronomurphsicles/chrono
@time/timemurphsicles/time

Reserved namespaces ensure package integrity. To request a new namespace, open an issue on the zorbs repository.

Package Versions

Zorbs supports semantic versioning (SemVer). Version requirements follow the same format as Cargo.toml:

"0.3"       — any 0.3.x version
"^1.0"      — compatible with 1.0 (default)
"~1.2.3"    — any 1.2.x
">=1.0, <2.0" — version range

Downloading Packages

Each package version is downloadable as a .zorb archive. The download URL follows this pattern:

https://zorbs.io/@{scope}/{name}/{version}/download

For unscoped packages:

https://zorbs.io/{name}/{version}/download

Package Resolution API

Zorbs provides a resolution API for the zorb CLI and zorb.toml solver:

GET https://zorbs.io/api/resolve?name={name}&version={req}

Returns the latest matching version and download URL as JSON.

Authentication

Sign in with GitHub, Google, X (Twitter), or Passkey (WebAuthn) to publish packages. No passwords needed — just your existing account.

Click "Sign in" on any page to get started.