# MantleOS

> Self-hosted AI brain: one structured memory (seven layers, one Postgres) that
> ingests your email, files, notes, and conversations, with an autonomous
> assistant living inside it. Self-hosted software, not a hosted service;
> one brain per install. Dual-licensed FSL-1.1-MIT + commercial.

## Install

- [AI installation runbook](https://mantleos.io/ai-install.md): the
  authoritative agent-oriented install procedure: requirements, the two
  compose projects (brain + MantleOS owner UI), the env-var contract
  (`MANTLE_YES=1` for a silent install, `MANTLE_DOMAIN` for HTTPS,
  `MANTLE_CHANNEL`, sandboxes, media, local embedder), domain-vs-IP, Caddy
  pointing, health checks.
- One-liner: `curl -fsSL https://raw.githubusercontent.com/crossworks-engineering/mantle/main/install.sh | bash`
  (prompts when a terminal exists; agents set `MANTLE_YES=1`)
- Requirements: a Linux box with Docker Engine and the compose plugin; more
  than 4 GB RAM for the full stack, 4 GB fits the core shape.

## The client

- [MantleOS Desktop](https://mantleos.io/desktop/): the owner UI, web and
  desktop, in its own repository at
  https://github.com/crossworks-engineering/jackdaw
- [Desktop downloads](https://github.com/crossworks-engineering/jackdaw/releases):
  Linux, macOS (unsigned today) and Windows

## Docs

- [Repository](https://github.com/crossworks-engineering/mantle)
- [Self-hosting](https://github.com/crossworks-engineering/mantle/blob/main/docs/self-hosting.md)
- [Getting started](https://github.com/crossworks-engineering/mantle/blob/main/docs/getting-started.md)
- [Architecture](https://github.com/crossworks-engineering/mantle/blob/main/docs/architecture.md)
- [Licensing, plain language](https://github.com/crossworks-engineering/mantle/blob/main/LICENSING.md)