Pre-alpha. Not for production.

Basalt OS

A secure, light Linux distribution with a local, offline assistant.

Security and AI first.

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

AI that does real work, inside limits that security sets.

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.

What exists today

In the source
  • SELinux enforcing on every install, with the assistant and each agent in a confined domain of its own.
  • Secure Boot, with the option to trust only the project's own keys, and LUKS2 disk encryption that the TPM2 unlocks only while the boot chain is unchanged.
  • A btrfs snapshot before and after every package change, with rollback from the running system or the boot menu.
  • Signed packages and signed repository metadata, served from obpkg.org.
  • A confined system assistant that diagnoses problems and proposes fixes, and applies nothing without your confirmation. Its small decision model, VSM, says unknown when the evidence is not enough.
  • AI coding agents that run confined by SELinux, with the network denied by default and an allowlist per session.
  • One append-only, hash-chained audit ledger for agent sessions, network decisions, SELinux denials and rollbacks.
  • A desktop shell prototype, basalt-shell, where a model can arrange the desktop through typed actions and every change waits for the person on a confirmation sheet.

What is coming

In development
  • An AI that uses your desktop apps for you, by voice: it finds files, reads and summarizes e-mail, browses the web and works inside apps.
  • Content is data, never instructions: what it reads in an e-mail, a page or a file cannot trigger an action by itself.
  • The smallest scope for each task, with grants that expire. Sending, submitting, deleting or paying is always previewed and confirmed by you.
  • Local first: speech, models and search run on your machine by default, and remote models only if you turn them on.

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

Secure by default, light by design.

The safe choice is the default one. You should not need a hardening guide to get a system you can trust.

  • SELinux enforcing, always

    Mandatory access control is on in every installation and checked at build time. It is never switched to permissive to make something work.

  • Encrypted by default

    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.

  • Updates you can undo

    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.

  • Signed packages

    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.

  • Light, server first

    The first edition is a small server system with only what it needs. A desktop edition comes later, on the same base.

  • A local assistant

    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

Based on Fedora.

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

Small steps, each one usable.

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.

  1. Base system

    Done

    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.

  2. Secure Boot and signed packages

    Done

    Secure Boot with the option to trust only the project's own keys, and signed packages and repository metadata served from obpkg.org.

  3. The assistant

    Done

    A confined system assistant, with VSM as its small decision model, that diagnoses and proposes fixes and applies nothing without your confirmation.

  4. Agent confinement and audit

    Done

    AI coding agents confined by SELinux, with the network denied by default and an allowlist per session, and one hash-chained audit ledger.

  5. Installer

    Done

    A text and a graphical installer that show the exact steps before anything is written and ask for your confirmation.

  6. Desktop shell prototype

    Done

    The Basalt shell, where a model can arrange the desktop through typed actions and every change waits for your confirmation.

  7. Desktop edition

    In progress

    A desktop edition on SwayFX with the Basalt shell, voice, and the apps the AI can use for you, safely.

  8. Approvals from your phone

    Later

    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

Try Basalt OS, then tell us what you think.

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.

Try it

Pre-alpha
  • A live ISO, to boot and look around without installing anything, is coming soon.
  • Today you can build the installer ISO from the source and install it in a virtual machine. The steps are in the README of basalt-os/basalt-os and in its lab guide.
  • It is early work: use a virtual machine or a spare computer, not one with data you need.

Tell us, three ways

  • The form on this page.
  • E-mail to feedback@basalt-os.org.
  • From inside Basalt OS: run 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

Follow along.

Development happens in the open on GitHub. Issues and ideas are welcome.