Quick tour
Five minutes to the shape of Faber: install the CLI, read one function, then open a real package. For a sequenced path, follow: Install → Hello → Commands → Projects.
1. Install the CLI#
Download the current release (1.6.0) for your platform from the
install page, verify the archive checksum, and put the
extracted faber-v1.6.0-<target-triple>/faber binary on your PATH. Confirm:
faber --version2. Shape of a function#
Type-first parameters, glyph return type, Latin control words, nullable union:
functio divide(numerus a, numerus b) → numerus ∪ nihil {
si b ≡ 0 ergo redde nihil
redde a / b
}| Signal | Meaning |
|---|---|
fn | Function declaration |
numerus a | Type first, then name |
→ | Return type |
∪ nihil | Nullable (T ∪ nihil) |
si … ergo | Compact branch |
return | Return |
3. Package layout#
A package is a directory with faber.toml and src/:
my-app/
faber.toml
src/
main.fabTypical commands:
faber check my-app/
faber build my-app/ -t rust
faber run my-app/
faber test my-app/Details: Faber build tool.
4. Real applications#
Do not stop at hello-world. The public examples repo has multi-command CLIs, a local mailspace, GPU workload tracks, and a full language corpus.
| Package | What it shows |
|---|---|
| AI Workbench | Multi-command CLI, model inspect, embeddings |
| ViviLite | File-backed mailspace / agent coordination CLI |
| coreutils | Larger application campaign (parity harnesses) |
| gpu-workload | Systems / GPU rungs |
| corpus | One directory per language construct |
Browse them on the examples page.
5. If you are an agent#
- Read
/llms.txt. - Open
/agents/index.md. - Pick a skill from
/.well-known/agent-skills/index.json.
Start track#
| Step | Page | Outcome |
|---|---|---|
| 1 | Install & download | Put Faber 1.6.0 on PATH and verify it |
| 2 | Hello, Faber | Create and run salve-munde |
| 3 | Commands you will use | Learn check, build, run, test, explain |
| 4 | Projects and examples | Move into real packages and corpus pages |