Novaterra

Find your way in

What Novaterra is The seven pillars, the constitution, and why the desktop is the product.

Getting started Requirements, install, environment variables, and your first arrival.

The Living Desktop Widgets, themes, signals and the omnibar — your sanctuary.

Your Twin Memory, profile, and the connections that feed them: files, mail, history.

Muse The conversational face of your Twin, and how it thinks.

The Studio Briefs become task graphs; agent teams turn them into real outputs.

API reference Every entity, REST route and WebSocket event, generated from the contracts package.

The seven pillars

Novaterra is one product built from seven parts, and each one is real code you can run:

1. Living Desktop — a full-screen, theme-driven living background with glass widgets that surface the right thing at the right moment.
2. Twin — your digital twin: memory, profile, files, mail, history. It learns and acts on your behalf.
3. Muse — your best friend and assistant, the voice of the Twin.
4. Studio — generates anything: text, documents, images, code, full React + Node sites, 3D scenes.
5. Agent Teams — crews of agents carrying skills, planning and executing the Studio’s work.
6. Marketplace — trade generators, skills, agents and work.
7. Souls — every being here, human or AI, has a personality, values, a voice and a mood.

Everything in these docs describes software in this repository. The API reference is generated straight from packages/contracts, so it can never drift from the code that runs.