⚙️ grio — A Blazing Fast, Pure Rust Alternative to Gradio
grio is a declarative web framework for Rust AI, ML, and data applications. Define components and event handlers in pure Rust, and grio instantly serves:
- A modern, reactive real-time Web UI (CSS3 + Vanilla JS, zero frontend dependencies, zero npm build).
- A full auto-generated REST API (
/api/predict,/api/schema,/docsSwagger UI,/api/openapi.json). - Interactive Client Code Generator (
⚡ Use via APImodal with ready-to-use Python, JavaScript, cURL, and MCP Tool snippets). - Native i18n & Dark/Light Themes out-of-the-box.
┌───────────────── Rust (Your Application) ─────────────────┐
│ App::new("⚙️ AI Studio") │
│ .item(Text::new("prompt")) │
│ .item(Slider::new("steps").min(10).max(50)) │
│ .item(Chatbot::new("chat")) │
│ .on_click("generate", |ctx| { ... }) │
│ .launch("127.0.0.1:7860") │
└──────────────────────────┬────────────────────────────────┘
▼
┌─────────────────────────────┐
│ ⚙️ grio │
├─────────────────────────────┤
│ UI GET / │ Page + Components (HTML5/CSS3/ES6)
│ GET /assets/* │ styles.css + app.js (Zero node_modules)
│ WS /ws │ Bi-directional Real-Time Event Bus
│ API GET /api/schema │ Auto-generated Schema Manifest
│ POST /api/predict │ Unified REST Execution Pipeline
│ GET /docs │ Interactive Swagger UI
│ GET /api/openapi │ OpenAPI 3.0.3 Specification
└─────────────────────────────┘
📖 Full Component Reference: See COMPONENTS.md for detailed APIs, parameters, and code examples for all 35+ built-in widgets.
🚀 Quick Start
Add grio to your Cargo.toml:
[]
= "0.1.0"
Create examples/greet.rs:
use *;
Run it with Cargo:
# → ⚙️ grio running at http://127.0.0.1:7860
🎨 Built-in Examples
| Example | Command | Highlights |
|---|---|---|
| Flagship: IT Service Desk | cargo run -p grio --example it_desk |
Production-grade Enterprise Support App connected to LM Studio local LLM, interactive Service Catalog (DataEditor), Rich incident reports (RichText), RAG citations (Pdf), realtime hot-slots (DynamicContainer), and user telemetry (Drawer). |
| All-in-One Showcase | cargo run -p grio --example showcase (or grio showcase) |
1-line gallery of all 35+ components in 6 tabs: Forms, Media, Data, DAG Workflows, AI Chat & Dynamic Slots, System Telemetry. |
| Multimodal AI Studio | cargo run -p grio --example prompt_to_image |
Autoregressive LLM (Candle Qwen 2.5 7B GGUF) + SDXL Image Diffusion + Live Analytics Dataframe & Plots |
| Rich Data & Dynamic Slots | cargo run -p grio --example rich_data_slots |
Micro-editor Markdown (RichText), interactive grid with typed checkboxes (DataEditor), and runtime hot-slot injection (DynamicContainer). |
| Multi-Page & Drawer | cargo run -p grio --example multi_page_drawer |
Declarative SPA multi-page navigation (app.page) + Sliding offcanvas drawer. |
| Chatbot | cargo run -p grio --example chatbot |
Conversational Chatbot widget with token-by-token streaming |
| Big Data & WebGL GPU Accelerator | cargo run -p grio --example bigdata_accelerator |
Zero-copy binary streaming (Float32Array), 1M+ points at 60 FPS (WebGlPlot), and multidimensional OLAP pivot tables (PivotTable). |
| Model Context Protocol (MCP) Server | cargo run -p grio --example mcp_agent_server |
Official Anthropic MCP v2024-11-05 endpoint (/mcp/v1) for Claude Desktop, Cursor & Windsurf tool-calling. |
| Enterprise SSO & RBAC | cargo run -p grio --example enterprise_sso |
Turnkey Single Sign-On (GitHub, Google, Keycloak, OIDC, Mock dev profiles), role-based access control, session cookies, and route protection (.require_role()). |
| Chromatix Visual Passkey | cargo run -p grio --example chromatix_passkey |
Air-gapped & Lab Authentication using HMAC-signed PNG badges with sealed timestamps and tamper detection. |
| Media & Vision | cargo run -p grio --example media |
Image, Audio (live mic streaming), Video (live camera streaming), PDF Viewer |
| Grid & Containers | cargo run -p grio --example grid |
Responsive Grids, Rows, Columns, Panels, and Accordions |
| Theming & Tabs | cargo run -p grio --example theme_and_tabs |
Multi-tab workflows, light/dark themes, brand accent customization |
📦 Project Architecture
d:\Projet\UI
├─ Cargo.toml Workspace root
├─ README.md Main documentation
├─ COMPONENTS.md Comprehensive component reference
├─ CHROMATIX_AUTH.md Chromatix Visual Passkey & Steganography Auth Guide
├─ PLUGINS.md WebAssembly sandbox plugin engine & ABI guide
├─ ROADMAP.md Completed phases and feature checklist
└─ crates/
├─ grio Core framework crate
│ ├─ src/
│ │ ├─ lib.rs Public API exports & crate documentation
│ │ ├─ app.rs App builder & event distribution engine
│ │ ├─ auth.rs Enterprise Auth & RBAC (OIDC, OAuth2, Chromatix Pixel Passkeys)
│ │ ├─ ai.rs Multi-engine LLM connectors (LM Studio, Ollama, OpenAI)
│ │ ├─ mcp.rs Official Model Context Protocol (MCP v2024-11-05) Server
│ │ ├─ wasm.rs Sandboxed WebAssembly Plugin Engine & Extensible ABI
│ │ ├─ components/ Modular Rust Component implementations
│ │ │ ├─ mod.rs Core traits, WithLayout, and component re-exports
│ │ │ ├─ layout.rs Row, Column, Panel, Grid, Tabs, Accordion, Drawer, DynamicContainer
│ │ │ ├─ forms.rs Text, Number, Slider, Checkbox, Dropdown, Radio, RichText, File...
│ │ │ ├─ media.rs Image, AnnotatedImage, ImageComparison, Audio, Video, Pdf, Model3D
│ │ │ ├─ data.rs Dataframe, DataEditor, WebGlPlot, PivotTable, Code, Json, Map...
│ │ │ └─ special.rs Chatbot, Metric, Plot, Progress, NodeGraph, Timer, DownloadButton
│ │ ├─ context.rs Handler Context API (get, set, append, append_f32_points, call_wasm, user)
│ │ ├─ events.rs WireEvent & EventName model
│ │ ├─ server.rs Axum HTTP/WebSocket/REST server & OpenAPI engine
│ │ ├─ showcase.rs Native All-in-One interactive showcase generator
│ │ └─ assets/ Embedded Zero-NodeJS Web Engine
│ │ ├─ styles.css Unified CSS3 design system (Variables, Themes, Glassmorphism)
│ │ └─ js/ Modular Vanilla JavaScript frontend
│ │ ├─ core.js App bootstrap, WebSocket client, event delegation, slots, binary
│ │ ├─ forms.js Standard inputs & RichText Markdown editor
│ │ ├─ data.js Dataframe, DataEditor, WebGL2 GPU Engine, OLAP PivotTable
│ │ ├─ media.js Media players, Inpainting Canvas, Pdf Document Viewer
│ │ ├─ special.js Chatbot streaming, NodeGraph DAG workflow editor, OpenStreetMap
│ │ ├─ router.js MultiPage SPA client router, Auth header & History API
│ │ └─ i18n.js Multi-language translation engine
│ └─ examples/ Showcase examples (it_desk, enterprise_sso, agent_hub, bigdata_accelerator, wasm_plugins...)
└─ grio-cli Standalone developer CLI tool
🛠️ Declarative Rust API
Core Widgets
| Component | Kind | Role | Description | Key Builder Methods |
|---|---|---|---|---|
Text |
text |
Input | Single-line or multi-line text input | .label(), .value(), .placeholder(), .lines(), .interactive() |
RichText |
richtext |
Input | Markdown micro-editor with formatting toolbar & live preview | .label(), .value(), .placeholder(), .lines(), .preview() |
Number |
number |
Input | Numeric field with min/max/step & ± stepper | .label(), .value(), .min(), .max(), .step(), .unit() |
Slider |
slider |
Input | Numeric range slider | .label(), .min(), .max(), .step(), .value(), .unit() |
SliderRange |
sliderrange |
Input | Dual-thumb bounded range selector [min, max] |
.label(), .min(), .max(), .step(), .value(low, high) |
Radio |
radio |
Input | Mutually exclusive selector (segmented pills or classic) | .choices(), `.style("pills" |
Checkbox |
checkbox |
Input | Boolean toggle checkbox | .label(), .value(), .interactive() |
Dropdown |
dropdown |
Input | Select box (single, multiple, searchable) | .choices(), .multiple(), .allow_custom(), .value() |
DataEditor |
dataeditor |
In/Out | Interactive data grid with typed columns, checkboxes & CSV copy-paste | .column(), .data(), .allow_add(), .allow_delete(), .allow_paste() |
DatePicker / TimePicker |
date / time |
Input | Native ISO date (yyyy-mm-dd) & time pickers |
.label(), .min(), .max(), .value() |
ColorPicker |
colorpicker |
Input | Palette selector with hex code & quick swatches | .label(), .value(), .presets() |
SortableList |
list |
Input | Drag & drop reorderable items list | .label(), .items(), .value() |
File |
file |
Input | Multi-file upload (click / drag & drop, progress) | .label(), .multiple(), .types(), .max_size() |
Explorer |
explorer |
Input | Server-side directory and file browser | .root(), .pattern() |
AudioRecorder |
audiorecorder |
Input | Live microphone recorder with animated pulse & timer | .label(), .max_duration(), .interactive() |
Chatbot |
chatbot |
Output | Interactive conversation thread with token streaming | .messages(), .placeholder(), .height() |
Pdf |
pdf |
Output | In-app document & PDF viewer with page navigation & RAG highlights | .src(), .page(), .zoom(), .highlight() |
NodeGraph |
nodegraph |
In/Out | ComfyUI-style visual workflow DAG editor with bezier connectors | .node(), .edge(), .height() |
Output |
output |
Output | Standard rendered text or JSON output | .label(), .value() |
Markdown |
markdown |
Output | GitHub-flavored markdown renderer | .text(), .value() |
Metric |
metric |
Output | Analytics KPI card with value & delta badge | .label(), .value(), .delta(), .delta_color(), .unit() |
Progress |
progress |
Output | Dynamic progression (horizontal bar, SVG circle, or pie) | .bar(), .circle(), .pie(), .size() |
Plot |
plot |
Output | Pure SVG Charts (line, bar, scatter) |
.variant(), .title(), .xlabel(), .ylabel(), .colors() |
AnnotatedImage |
annotatedimage |
Output | Bounding boxes overlay (labels, confidence scores, colors) | .image(), .box_norm(), .boxes() |
ImageComparison |
imagecomparison |
Output | Interactive before/after sliding curtain | .before(), .after(), .position() |
HighlightedText |
highlightedtext |
Output | NLP/NER text with labeled spans and color legend | .segments(), .color_map(), .show_legend() |
CodeDiff |
codediff |
Output | AI code refactoring diff with +/- line indicators |
.old_code(), .new_code(), .language() |
Model3D |
model3d |
Output | Lightweight WebGL 3D viewer (Wavefront OBJ, orbit/zoom) | .value(), .clear_color(), .interactive() |
Map |
map |
In/Out | Interactive OpenStreetMap with markers, radius circles, and clicks | .center(), .zoom(), .marker(), .circle() |
Dataframe |
dataframe |
In/Out | Interactive editable & sortable spreadsheet | .headers(), .data(), .sortable(), .addable(), .interactive() |
Gallery |
gallery |
In/Out | Media visualizer with lightbox popup | .label(), .columns(), .upload(), .interactive() |
ImageEditor |
imageeditor |
In/Out | Full canvas editor (draw, inpainting mask, crop, filters) | .brush(), .crop(), .filters(), .layers() |
Code |
code |
In/Out | Syntax-highlighted code editor | .language(), .lines(), .theme(), .interactive() |
Json |
json |
In/Out | Live-validated JSON editor / viewer | .label(), .value(), .interactive(), .output() |
Html |
html |
In/Out | Custom HTML/CSS/JS with event delegation & window.grio |
.value(), .input(), .output() |
WebGlPlot |
webglplot |
Output | Hardware-accelerated GPU 1M+ points time-series | .series(), .max_points(), .height() |
PivotTable |
pivottable |
In/Out | Multidimensional OLAP cube with dynamic aggregations | .row_dimensions(), .col_dimensions(), .aggregator() |
Label |
label |
Output | Gradio-style value badge with semantic color | .label(), .value(), .variant(), .size() |
Timer |
timer |
Output | Periodic clock emitting change each tick |
.label(), .interval(), .running() |
DownloadButton |
download |
Output | Server-triggered file download | .label(), .filename(), .value() |
Containers & Layouts
DynamicContainer(DynamicContainer::new("slot_id")): Server-driven runtime component injection, replacement, or clearing via WebSockets (ctx.append_component,ctx.replace_children,ctx.clear_container).Drawer(Drawer::new("drawer_id")): Slide-in side drawer panel (left,right,top,bottom) with backdrop blur for telemetry, settings, and inspector panels.MultiPage(app.page("/route", "Title", |p| ...)): Declarative multi-page routing with automatic responsive sidebar.Row(b.row(|r| ...)): Horizontal flexbox layout.Column(b.column(|c| ...)): Vertical stacking layout.Panel(b.panel("Title", |p| ...)): Card container with embossed border and header.Grid(b.grid(cols, |g| ...)): Responsive CSS grid layout (repeat(auto-fit, minmax(...))).Tabs(b.tabs(|t| t.tab("Tab 1", ...))): Client-switched multi-view workflow.Accordion(b.accordion("Details", |a| ...)): Collapsible<details>drawer.
⚡ Event Model & Context API
Event handlers are attached directly to the App builder and receive a rich Context:
new
.on_click
Context Methods Summary
ctx.get::<T>("id")/ctx.get_str("id")/ctx.get_f64("id"): Read deserialized input state.ctx.set("id", value): Update component value across all connected clients and API response.ctx.append("id", text): Stream incremental text/tokens directly to a component in real-time.ctx.append_component("slot_id", component): Inject a new live component into aDynamicContainerat runtime.ctx.replace_children("slot_id", vec): Replace all children inside aDynamicContainer.ctx.clear_container("slot_id"): Empty aDynamicContainer.ctx.set_visible("id", bool): Dynamically show or hide any component without losing state.ctx.progress("id", pct, "step"): Drive visual progress bars (0.0to1.0).ctx.alert(AlertLevel::Success, "msg"): Display color-coded toast notifications (Info,Success,Warn,Error).ctx.cancelled(): Check if the user cancelled or re-triggered the current job.
🔌 Automatic REST API & Client Code Generator
Every grio application automatically generates a complete REST API:
POST /api/predict: Execute the same pipeline as the UI programmatically.GET /api/schema: Machine-readable JSON manifest of all inputs, outputs, and widgets.GET /docs: Interactive Swagger UI documentation.GET /api/openapi.json: OpenAPI 3.0.3 compliant specification.
⚡ Interactive Use via API Modal
Every grio page features a footer launcher ⚡ Use via API providing copy-paste client code generated in real time:
- 🐍 Python (
requests):= - 🟨 JavaScript (
fetch/ async-await):const res = await ; console.log; - 💻 cURL:
- 🤖 MCP Tool (Model Context Protocol): Ready-to-use JSON tool definition for LLM agents (Claude Desktop, Cursor, local agentic systems).
🌐 Internationalization (i18n)
grio includes built-in multilingual support. Users can switch languages dynamically from the ⚙️ Settings modal:
- 🇬🇧 English
- 🇫🇷 Français
- 🇪🇸 Español
- 🇩🇪 Deutsch
All default component labels, file drops, empty states, and modal dialogs translate instantly without reloading the page.
📜 License
Licensed under the MIT License. Made with ❤️ for the Rust & AI Community.