Skip to content

PossumXI/AI_UI

Repository files navigation

AI_UI — The AI Shell We Need.

A GPU-accelerated, AI-native desktop shell built in Rust. The interface designed for the age of AI.

License: MIT Rust Platform

Overview

AI_UI is an AI-native desktop shell that reimagines how we interact with our computers. Built with Rust, iced, and wgpu, it brings:

  • AI Command Bar — Invoke Claude or Ollama anywhere with Ctrl+Space
  • App Launcher — Fuzzy search across all installed applications
  • System Taskbar — Real-time WiFi, memory, battery, and clock
  • MCP Integration — Model Context Protocol for tool use and extensibility
  • Cross-Platform — Windows, Linux, and macOS with GPU-accelerated rendering

Quick Start

Prerequisites

Build & Run

# Clone the repository
git clone https://github.com/PossumX/AI_UI.git
cd AI_UI/ai-ui

# Debug build (faster compilation)
cargo build

# Release build (optimized)
cargo build --release

# Run the shell
cargo run -p ai-ui-shell

Configuration

Set your Anthropic API key (for Claude):

# Option 1: Environment variable
export ANTHROPIC_API_KEY="sk-ant-..."

# Option 2: Config file
# ~/.config/ai-ui/config.toml (Linux/macOS)
# %APPDATA%\ai-ui\config.toml (Windows)

See Configuration and the Wiki for full setup.

Architecture

Crate Purpose
ai-ui-shell Main binary — iced UI, Elm architecture, wgpu rendering
ai-ui-ai AI integration — Claude API, Ollama fallback, MCP protocol
ai-ui-system System interaction — app enumeration, fuzzy search, status, hotkeys

Features

Feature Description
AI Command Bar Ctrl+Space — Claude API streaming, markdown rendering
App Launcher Fuzzy search with nucleo-matcher, instant launch
Taskbar WiFi, memory, battery, clock — always visible
Claude + Ollama Cloud-first with local fallback, keyring storage
MCP Tool use, file access, extensible JSON-RPC
Cross-Platform Windows, Linux, macOS — GPU via wgpu

Documentation

Project Structure

AI_UI_Framework/
├── ai-ui/                    # Rust workspace
│   ├── crates/
│   │   ├── ai-ui-shell/      # Main binary
│   │   ├── ai-ui-ai/         # AI integration
│   │   └── ai-ui-system/     # System interaction
│   ├── assets/
│   └── Cargo.toml
├── LICENSE
└── README.md

Contributing

Contributions are welcome. Please read the Contributing guide on the wiki.

License

MIT License — see LICENSE for details.

Copyright (c) 2024-2026 Opal Mar Group Corporation, Arobi, Arobi Technology Alliance, Asgard, and Aura Genesis Foundation.

About

AI_UI the AI Shell we need

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors