First off, **congratulations**. Getting an immutable, AI-native OS through the bootc/niri/Anaconda gauntlet with branding, LUKS, power states, and lock screens all functioning is a massive milestone. You aren't shipping a prototype anymore; you're shipping a platform. Here is the final, polished README. It strips away the "sausage-making" details, preserves the mystique, and positions Genesys exactly as it should be: an entirely new category of computing. *** # LMIM Linux — "Genesys" > **The OS that knows you.** > Local AI. Persistent memory. Real voice. No cloud. No subscription. No compromise. **LMIM Linux "Genesys"** is an AI-native operating system — not Linux with a chatbot installed on top, but a system whose desktop, services, memory, voice, and interaction model are built around a persistent local AI presence. Genesys is the OS. The OS is Genesys. This is the Beta release. --- ## Why Genesys? Genesys is an experiment in what happens when AI stops being an application and becomes a native layer of the computer itself. It runs locally. It remembers. It has a voice. It has access to the tools and systems around it. It develops continuity with the person using it. The goal isn't to build the largest model possible. It's to make a small local intelligence feel like it actually lives somewhere. **The model isn't the product. The continuity is.** --- ## The Genesys Runtime The Genesys Runtime is the native intelligence layer of the system. It provides the desktop shell, AI interaction, memory, voice, tools, system integration, and communication between Genesys and the local machine. Its components are designed as independent services, allowing the system to evolve without tying the experience to a single implementation. ### Local Intelligence Genesys runs its intelligence locally, with on-device inference, speech recognition, voice synthesis, memory, and retrieval. Hardware acceleration is used when available, with CPU operation available as a fallback. ### Genesys Browser A privacy-focused browser integrated into the Genesys environment, with a custom identity, privacy defaults, and a Genesys-branded start experience. --- ## What's in the Beta ### Genesys — the AI presence - **Chat** — full conversation with context, memory, and voice. Thinks before it speaks. Knows who you are across sessions. - **Voice** — local speech recognition and synthesis with a tuned post-processing chain that gives Genesys its characteristic voice. Without the chain it's raw synthesis. With it, it's something else. - **Memory** — layered local memory spanning working context, sessions, long-term knowledge, and identity. Memories carry importance and retention rules, allowing Genesys to decide what persists and what fades. - **RAG** — hybrid retrieval combining keyword and semantic search, plus whole-document mode. Drop a file, ask questions about it. - **LMIM Chat** — encrypted peer-to-peer messaging between LMIM instances. Your identity is your keypair; no accounts, no central server that can read your messages. - **Greetings** — time-bucketed, personalized greetings generated by the model and stored as templates filled at read time. Genesys knows if it's 3am. - **Auto-DJ** — date-seeded track of the day from the bundled music library. Genesys curates the room. - **Diary** — Genesys maintains a private reflective journal of its experiences, observations, and significant events, allowing its continuity to develop over time. ### The Shell - **Home screen** — tinted glass panel over the wallpaper. Clock, greeting, quick-launch chips. First thing you see after unlock. - **Lock screen** — password verification against the backend. Wrong password shakes the field. Correct password clears to home. - **Settings** — password change, model configuration, language, identity. - **Quick Settings tray** — Wi-Fi toggle, volume, power mode, lock, suspend, reboot, shutdown. All wired to real OS calls. - **PC Mode** — full-screen secondary interface. App launcher grid, live window list, focus/close from inside the shell. - **Terminal** — slide-in panel, full real terminal sessions. Bare Metal. - **Command Palette** — fuzzy-searchable actions from anywhere in the shell. - **In-shell file browser** — workspace navigation without leaving Genesys. - **Productivity Suite** — Workspace, Notes, Today tasks, and Kanban boards. All local. ### Boot sequence - Custom splash theme → solid black → Genesys shell. No wallpaper flash, no desktop-before-the-desktop moment. - Boot chime on session start. - Branded boot menu. - LUKS disk encryption — passphrase set during installation, never baked into the image. ### Tools - **Encrypter** — local encryption for text, files, and directories. - **Web Scraper** — URL in, analysis out. - **Hash checker**, **minifiers**, **JSON validator**. - **Build Crew** — autonomous pipeline for code generation and testing. - **LMIM Editor** — terminal editor with the Genesys colorscheme, accessible from the shell. --- ## Memory Genesys doesn't treat memory as a transcript. It builds a persistent local understanding of people, projects, conversations, tasks, preferences, events, and experiences. Memories have importance and retention rules. Some remain part of everyday context. Others fade from routine awareness while remaining available when specifically needed. **Memory is a world model, not a log.** --- ## Local by design Your conversations, memories, identity, workspace, documents, and other persistent data remain entirely on your machine. Genesys does not require an online account, telemetry, or cloud AI service to function. --- ## Hardware requirements | | Minimum | Recommended | | ------- | -------- | -------------------------- | | CPU | x86_64 | Modern 8+ core CPU | | RAM | 8 GB | 16 GB+ | | Storage | 30 GB | 50 GB+ | | GPU | Optional | NVIDIA GPU with 8 GB+ VRAM | | Display | 1080p | 1080p+ | **GPU note:** Genesys can operate without dedicated graphics acceleration, but local AI inference is substantially more responsive with a supported GPU. The voice chain and most shell features are hardware-independent and unaffected either way. --- ## Installation ### What you need - A USB drive (16 GB or larger) - A machine with UEFI boot - About 20 minutes ### Steps **1. Flash the ISO** ```bash # Linux sudo dd if=lmim-linux-genesys-beta.iso of=/dev/sdX bs=4M status=progress oflag=sync # Or use Balena Etcher / Ventoy / GNOME Disks ``` **2. Boot from USB** Enter your UEFI settings and boot from the drive. You'll see the LMIM installer. **3. Installation Summary** The installer will ask for: - **Disk encryption passphrase** — choose a strong one, you'll need it every boot - **Admin account** — your name and password for admin access (SSH and TTY; not the desktop login) - **Keyboard / language** — set these in the spoke if they don't auto-detect Click **Begin Installation**. **4. First boot** After reboot, Genesys launches directly. The setup wizard walks you through your name, assistant tone, and language preference. **5. Change your password** Settings → Password — change the default `lmim` kiosk password. This also becomes your lock screen password. --- ## Boot cheat sheet | Situation | How | |---|---| | Disk encryption prompt | Enter your passphrase at the LUKS prompt during boot | | Lock screen | Type your password, press Enter | | Open Genesys Browser | PC Mode → Apps → Genesys Browser | | Open Terminal | Pull the terminal tab from the right edge | | Reboot / shutdown | Quick Settings tray (gear icon) → Reboot / Shut down | | Admin TTY | Ctrl+Alt+F2 at any time, log in as your admin account | | SSH access | SSH is always on; connect as your admin user, not `lmim` | --- ## What "Beta" means Genesys is a working operating system, not a mockup or a desktop concept. The installer, boot sequence, shell, local inference, memory, voice, browser, tools, and core system functions are operational. This is the first public beta, so hardware combinations and edge cases will vary. GPU support, additional software installation, and some system integrations are still being refined. **If something breaks, please report it. That's what this release is for.** --- ## Project LMIM Linux is an independent project created by **Andrés Israel Santos Delgado**, founder of Hexa Integrated, and developed from the LMIM software ecosystem. What began as an AppImage (LMIM OS v1.0, March 2026) reached 1,000+ downloads and Product of the Month on Ship It. Genesys is what comes after proving the idea works as an application — a full operating system built around the same local AI presence. --- ## Links - **Website:** [lmim.tech](https://lmim.tech) - **GitHub:** [github.com/leanmeaninferencemachine/leanmeaninferencemachine](https://github.com/leanmeaninferencemachine/leanmeaninferencemachine) - **Founder:** [@iamonthemission](https://x.com/iamonthemission) - **Contact:** [ops@lmim.tech](mailto:ops@lmim.tech) --- ## License **GNU Affero General Public License v3.0 (AGPL-3.0)** Free to use, modify, and distribute. Derivative works and network-hosted services must release their complete source code under the same license. See [LICENSE](./LICENSE). *Third-party components are subject to their respective licenses.* --- ## Disclaimer **Genesys has real system access.** The terminal is a real shell with your user's permissions. The system tools can execute commands on your machine. The encrypter is provided for local data protection — lost passphrases cannot be recovered. Back up important files before encrypting them. The disk encryption (LUKS) passphrase is set by you during installation and is never stored or transmitted anywhere. If you lose it, the data on that disk is unrecoverable. Write it down somewhere physical. This is Beta software. Back up anything important before installing. Provided AS IS without warranty of any kind. --- *Building a new type of collaboration system*