ricer

# 🍚 Ricer > **Under development:** This project is under active development and expected to be released later this year. Features and APIs may change. > _Describe your dream desktop. Let AI make it real._ **Ricer** is an AI-powered desktop customization assistant for Linux. Tell it what you want in plain English — _"make my panel look like macOS"_ or _"switch to a dark Breeze theme"_ — and Ricer stages the changes, explains exactly what it will do, and waits for your approval before touching anything. Built on the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/), Ricer bridges a conversational AI front-end with a provider layer that speaks directly to your desktop environment via D-Bus and native tooling. Every change is auditable. Nothing runs without your say-so. --- ## ✨ Features - 💬 **Natural-language customization** — just describe what you want; no config-file knowledge required - 🔍 **Read before you write** — Ricer inspects your current settings first and explains the proposed diff - ✅ **Confirm before applying** — all changes are staged in a changeset and only committed on your explicit approval - ↩️ **Rollback support** — undo any session and restore your previous desktop state - 🖥️ **Multi-DE support** — KDE Plasma 6 and Cinnamon providers included out of the box - 🧩 **MCP-native architecture** — extend with new desktop providers or tools without touching the core --- ## 🏗️ How It Works 1. You type a customization request in the chat window. 2. The LLM figures out which desktop settings to read or modify. 3. Changes are queued in a _changeset_ — **not applied yet**. 4. You review the plan; Ricer only touches your desktop after you confirm. --- ## Prerequisites Install uv: ```bash sudo pacman -S uv ``` Or with curl: ```bash curl -LsSf https://astral.sh/uv/install.sh | sh ``` ## Setup 1. Create and activate virtual environment: ```bash uv venv source .venv/bin/activate ``` 2. Install dependencies: ```bash uv sync ``` ## Run ```bash uv run python main.py ```