Build from source

Clone the repo, hack on it, make it yours. llumos is MIT-licensed open source.

$ git clone https://github.com/llumos/llumos $ cd llumos && npm install $ npm run dev

View on GitHub Read the docs

What you'll find inside

llumos/

├── electron/Main process

│ ├── main.tsWindow management

│ ├── agent/

│ │ ├── engine.tsClaude agent integration

│ │ └── prompts/Agent behavior (markdown)

│ └── ipc/

│ └── handlers.tsAll IPC handlers

├── src/Renderer (React UI)

│ ├── App.tsxMain component

│ ├── components/Chat, Sidebar, Settings

│ └── stores/Zustand state management

├── website/This website

└── package.json

The dev workflow

Fork and clone

$ git fork https://github.com/llumos/llumos && git clone ...

Standard GitHub flow. Fork the repo, clone your fork.

Start dev mode

$ npm run dev

What will you build?

Notes

Dashboard

Player

Vite + Electron hot-reloads as you code.

Make changes

Editor

import { useState } from 'react'

const [count, setCount] = useState(0)

Preview

Edit code, see changes instantly. No manual rebuild.

Contributing

Fork

Branch

Code

Review

Merge

We welcome contributions of all sizes — from typo fixes to new features. Check the contributing guide and open issues.

Contributing Guide Open Issues

The dev experience

$ npm run dev

vite v5.4 dev server running at http://localhost:5173/

electron: main window ready

llumos: agent engine initialized

llumos: ready ✓

Other ways to get started

Try on the web

Start building in your browser — no install needed.

Download the app

Native desktop app for Mac, Windows, and Linux.