basalt-os
OrganizationThe GitHub organization for Basalt OS.
Pre-alpha. Not for production.
A secure, light Linux distribution with a local, offline assistant.
Secure defaults from the first boot, updates you can undo because the system takes a snapshot before and after every change, and an assistant that runs on your machine. Install it once and keep it current with dnf. Basalt OS is in early development and there is nothing to download yet.
Security and AI first
Every part of Basalt OS is designed so that AI agents can do real work on the system through typed, auditable actions, and so that this work is always confined, previewed and confirmed by a person. AI is not bolted on at the end.
When the two pull apart, security sets the limits and AI works inside them. Security is never relaxed to make AI easier. The security page explains the layers, their limits and how the model is versioned and audited.
This is the direction of the work, not a schedule.
Also from the OpenBasalt project: cotty, a shared terminal where you and an AI agent work
in the same session. It is early and in the basalt-testing channel, for testing. On
Basalt OS, install it with sudo dnf --enablerepo=basalt-testing install cotty.
More about cotty.
Principles
The safe choice is the default one. You should not need a hardening guide to get a system you can trust.
Mandatory access control is on in every installation and checked at build time. It is never switched to permissive to make something work.
Full disk encryption with LUKS2 is on from installation. The TPM2 unlocks the disk only while the boot chain is unchanged, and you keep a recovery key.
Install once and update with dnf; what you install stays across updates. A btrfs snapshot is taken before and after every package change, so you can roll back from the running system or pick a snapshot in the boot menu. Home, logs and databases live in their own subvolumes and a rollback never touches them.
Packages and the repository metadata are signed, and the system checks signatures before it installs an update. Signed checksums for the installation media are planned.
The first edition is a small server system with only what it needs. A desktop edition comes later, on the same base.
It diagnoses problems and proposes actions, and never acts without your confirmation. It works offline, and you can plug in a bigger model if you choose to.
Base
Basalt OS is a traditional, package-based Fedora derivative. It uses Fedora packages from Fedora's own mirrors, the Fedora kernel and its signed boot chain. Basalt OS adds its own defaults, tools and assistant, and a small signed package repository.
Basalt OS is an independent project. It is not affiliated with or endorsed by the Fedora Project or Red Hat.
Roadmap
The order of the work, not a schedule. Done means it works in the source today; nothing is released yet, and plans can change as we learn.
An installable server system: btrfs on LUKS2 with TPM2 unlock, a snapshot before and after every update, and rollback from the running system or the boot menu.
Secure Boot with the option to trust only the project's own keys, and signed packages and repository metadata served from obpkg.org.
A confined system assistant, with VSM as its small decision model, that diagnoses and proposes fixes and applies nothing without your confirmation.
AI coding agents confined by SELinux, with the network denied by default and an allowlist per session, and one hash-chained audit ledger.
A text and a graphical installer that show the exact steps before anything is written and ask for your confirmation.
The Basalt shell, where a model can arrange the desktop through typed actions and every change waits for your confirmation.
A desktop edition on SwayFX with the Basalt shell, voice, and the apps the AI can use for you, safely.
Approve or refuse what the AI asks to do from a phone paired with your machine.
Screens of the work in progress, with their versions, are in the gallery.
Try it and tell us
Basalt OS is young, and what you notice now shapes what it becomes. Tell us what broke, what confused you and what you wish it did. A person reads every message.
basalt feedback. It shows you exactly what will be sent and sends nothing until you say yes. When voice arrives, you can just say "send feedback".Get involved
Development happens in the open on GitHub. Issues and ideas are welcome.
The GitHub organization for Basalt OS.
The source of the system and its tools.
Basalt OS is part of OpenBasalt, open source on solid ground.