Current Release Phase 0 — Docker Shell

Your AI desktop,
runs on your hardware

Genesis OS is an AI-native desktop shell running as a Docker container. One docker compose up gives you a full OS-like interface in your browser — AI chat, file manager, terminal, code editor and more. No cloud. No accounts. Everything stays on your machine.

Next: deploy Genesis OS on top of bare Linux as the sole frontend — turning any device into a dedicated Genesis OS machine.

🐳 Docker Shell 🖥️ Linux Native (next) 🍓 Raspberry Pi 💻 Electron 🔒 Local-First ⚡ MIT License

Not a chatbot. Not a cloud service.
An AI desktop shell.

Genesis OS runs as a Docker container, giving you a complete desktop-like interface in your browser — backed by a local AI model via Ollama. Everything runs on your hardware; nothing touches the cloud. The next step is to strip away the Docker + browser layer and run Genesis OS directly on Linux as the native graphical frontend.

🧠

Persistent Memory

Every conversation, file interaction, and context is stored locally in ChromaDB and SQLite. Genesis remembers — forever — without forgetting.

🔒

Truly Local-First

Zero telemetry. Zero cloud APIs in the critical path. Your data never leaves your machine. 100% air-gapped operation is fully supported.

🚀

Runs Any Model

Powered by Ollama, Genesis works with Gemma 4, Qwen 3, Mistral, Phi-4, LLaMA — any open model. Swap models with a single config change.

Built for everything
you do every day

🪐

AI Orb — Always Available

An animated AI presence lives in the corner of your screen at all times. Click to chat, hold to talk, never interrupts unless you need it.

Learn more →
🗂️

OS-Grade File Manager

Browse, preview, and manage your filesystem with a spatial file manager. Ask the AI to find, summarise, or edit any file by voice or chat.

Learn more →
🎤

Always-On Voice

"Hey Genesis" wake-word (openWakeWord), Whisper STT, and Piper TTS — all processed locally. No Alexa, no Siri, no surveillance.

Learn more →
🔧

Agentic Tool Use

Run shell commands, read/write files, search the web, send emails — all through natural language. Every destructive action requires your approval.

Learn more →

Integrated Terminal

A full PTY terminal powered by xterm.js. Ask the AI to explain error output, suggest commands, or run scripts directly in your workspace.

Learn more →
📄

Office & PDF Viewer

Open .docx, .xlsx, .pptx, and PDF files natively. Ask the AI to summarise documents, extract data, or answer questions about any file.

Learn more →
0K
Context Window (tokens)
$0
Cloud API cost — ever
0
Deployment targets
0%
Data stays local

One command.
Full AI-native desktop.

Genesis runs as a Docker stack — no installation wizard, no cloud account, no API keys. One command pulls the models, starts all services, and opens a world-class desktop UI in your browser.

  • Daemon (Node.js) orchestrates everything and exposes a real-time API
  • Ollama serves open models locally at the OpenAI-compatible endpoint
  • Python sidecars handle ChromaDB memory and Whisper/Piper voice
  • React UI renders a glassmorphic OS shell — no Electron required for Docker
Explore the Architecture →
Terminal — Start Genesis OS
# Clone and start — that's it
git clone https://github.com/shaik-shahansha/genesisAIOS
cd genesis-os

# One command boots everything
docker compose up

# Opens at http://localhost:3000
# Ollama auto-pulls gemma4:e4b (~9.6 GB)
# No GPU required — fast CPU inference

# Or choose a lighter model:
GENESIS_MODEL=gemma4:e2b docker compose up

Your hardware.
Your rules.

Genesis OS runs on whatever you have. From a MacBook to a Raspberry Pi to a bootable USB drive — the same codebase, the same experience.

🐳

Docker Container

The canonical deployment. docker compose up and you're running in seconds.

✓ Phase 0 — Ready
🖥️

Desktop App (Electron)

Native desktop experience on macOS, Windows, and Linux. Same UI, native file access, system tray orb.

⚡ Phase 4
💽

Bootable OS Image

Debian live-build image. Write to USB, boot any x86 machine, and you have a dedicated AI OS with no dependencies.

⚡ Phase 4
🍓

Raspberry Pi

Pi-optimised image with GPIO tools, picamera2 vision feed, and hardware control. Your home server becomes an AI physical agent.

Phase 5 — Robotics
🌐

Web Demo (WebGPU)

Fully browser-based demo using Transformers.js with WebGPU acceleration. Try Genesis OS without installing anything.

Phase 4 — Web

Proven stack.
Zero compromises.

Node.js

Daemon core, API server, event bus, file watcher. Async everywhere.

🐍
Python

ChromaDB memory, Whisper STT, Piper TTS, openWakeWord sidecars.

🦙
Ollama

Local LLM serving. Any open model. OpenAI-compatible API. No GPU required.

⚛️
React + Vite

OS shell UI. Glassmorphism design. Framer Motion animations. No framework lock-in.

Better than macOS.
Powered by AI.

Every pixel crafted to feel native, fast, and effortless — with an AI layer woven into every surface.

localhost:3000 — Genesis OS Desktop
🖥️

Screenshot: Genesis OS Desktop — replace with assets/images/desktop-screenshot.png

AI Chat
💬

Screenshot: AI Chat — assets/images/chat-screenshot.png

File Manager
📁

Screenshot: File Manager — assets/images/files-screenshot.png

Terminal

Screenshot: Terminal — assets/images/terminal-screenshot.png

Meet the creator

Shahansha Shaik

Shahansha Shaik

AI ENTHUSIAST

Passionate about building AI systems that belong to their users. Created Genesis OS to give everyone a persistent, private, local-first AI presence — one that runs on your own hardware, remembers your world, and acts as a true intelligent layer over your digital life. No cloud. No subscription. No limits.

Your AI. Your machine. Your rules.

Launch the full Genesis OS stack in under a minute. No cloud account. No API keys. No monthly bill.