explaingit

fantasylab-ai/emberos

Analysis updated 2026-05-18

4HTMLAudience · developerComplexity · 4/5Setup · hard

TLDR

A phone-first Linux desktop system, split into a Head interface and an Engine daemon, with a file explorer, terminal, editor, and an AI assistant.

Mindmap

A visual breakdown will appear here once this repo is fully enriched.

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a full Linux desktop on an Android phone with no other hardware required.

USE CASE 2

Pair an iPhone as a Head to an Engine running on a Raspberry Pi, server, or old Android phone.

USE CASE 3

Use the built in Ember assistant to read files, notes, and calendar, and propose changes you approve.

USE CASE 4

Connect a GitHub account to browse and clone repositories directly from the phone.

What is it built with?

GoHTMLJavaScriptWebSocketxterm.js

How does it compare?

fantasylab-ai/emberosasabeneh/speaksuomibmschmidt/bookwormblog
Stars444
LanguageHTMLHTMLHTML
Last pushed2026-05-292015-05-22
MaintenanceMaintainedDormant
Setup difficultyhardeasymoderate
Complexity4/51/53/5
Audiencedevelopergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires building a Go binary and, for full mobile use, hardware to host the Engine plus a secure network connection like Tailscale.

In plain English

EmberOS turns your phone into what the project calls a real computer in your pocket. It splits into two parts: a Head, which is the interface you see and touch, and an Engine, which is a Linux system with a small daemon called emberd that actually does the work. Both parts talk to each other using the same protocol whether they sit on the same device or are separated by an ocean. On Android, the phone itself can run the whole Linux system on-device with no other hardware needed, which the project treats as its main track. Apple does not allow a full Linux system to run directly on an iPhone, so on iOS the phone only runs the Head, and the Engine lives on separate hardware you own, such as a Raspberry Pi, a personal computer, a rented server, or even an old Android phone, reached over a secure connection. Any regular web browser can also act as a Head by pointing it at an Engine, giving you the same desktop experience. Once paired, EmberOS provides a two pane file explorer, a real terminal with multiple sessions, a code editor with a live preview and a coding agent that can edit files, a retro game emulator with save syncing, and an assistant called Ember that can look at photos and screenshots, read your notes, files, and calendar, and propose changes you approve or reject before anything happens. It can also connect to GitHub to clone and browse repositories, install curated apps, and manage mail, calendar, and notes, all backed by real accounts and files stored on the Engine, not in the browser. Security keeps every secret, such as API keys and tokens, stored on the Engine with restricted file permissions rather than in the browser, and every automated action is written to a local audit log. Running it yourself means building the emberd binary in Go and either running it directly for local development or installing it on a Raspberry Pi 5 with a provided install script.

Copy-paste prompts

Prompt 1
Walk me through building and running the emberd binary locally to try EmberOS on my computer.
Prompt 2
Show me how to install an Engine on a Raspberry Pi 5 and pair it with my phone.
Prompt 3
Explain how EmberOS keeps API keys and tokens secure on the Engine instead of the browser.
Prompt 4
Help me understand how the Agent Inbox lets Ember propose file changes I can approve or reject.

Frequently asked questions

What is emberos?

A phone-first Linux desktop system, split into a Head interface and an Engine daemon, with a file explorer, terminal, editor, and an AI assistant.

What language is emberos written in?

Mainly HTML. The stack also includes Go, HTML, JavaScript.

How hard is emberos to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is emberos for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.