@amd-gaia/agent-ui 0.17.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (C) 2024-2025 ADVANCED MICRO DEVICES
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,101 @@
+# @amd-gaia/agent-ui
+
+Privacy-first agentic AI interface with document Q&A — runs **100% locally** on AMD Ryzen AI hardware.
+
+No cloud. No API keys. No data leaves your device.
+
+## Install
+
+```bash
+npm install -g @amd-gaia/agent-ui
+```
+
+## Prerequisites
+
+GAIA Agent UI requires the Python backend running locally:
+
+```bash
+# Install the GAIA Python package
+pip install amd-gaia
+
+# Start the LLM backend (AMD Ryzen AI accelerated)
+lemonade-server serve
+```
+
+## Usage
+
+```bash
+# Start GAIA Agent UI (launches backend + opens browser)
+gaia-ui
+
+# Custom port
+gaia-ui --port 4200
+
+# Frontend-only mode (if backend is already running)
+gaia-ui --serve
+
+# Don't auto-open browser
+gaia-ui --no-open
+```
+
+Then open [http://localhost:4200](http://localhost:4200) in your browser.
+
+## Features
+
+- **Private** — All processing runs locally on your AMD hardware. No data leaves your device.
+- **Streaming responses** — Real-time token streaming with live agent activity visualization.
+- **Document Q&A** — Upload PDFs, code files, and documents for RAG-powered question answering.
+- **Agent activity** — Watch the AI think, plan, and use tools in real time.
+- **Session management** — Create, search, rename, export, and delete chat sessions.
+- **Dark/light mode** — Automatic theme detection with manual toggle.
+- **Mobile access** — Share your local chat to your phone via secure tunnel.
+- **Markdown rendering** — Code blocks, bold, italic, lists, and links in responses.
+- **Keyboard shortcuts** — Enter to send, Shift+Enter for newlines.
+
+## Architecture
+
+```
+Browser  <-->  Python Backend (FastAPI, port 4200)  <-->  Lemonade Server (LLM, port 8000)
+                    |
+                SQLite DB (~/.gaia/chat/)
+```
+
+The npm package includes:
+- **Pre-built React frontend** served by the Python backend
+- **CLI launcher** (`gaia-ui`) that starts the backend and opens the browser
+- **Standalone serve mode** (`--serve`) for serving the frontend independently
+
+## Desktop Installers
+
+For a native desktop experience, download the installer from
+[GitHub Releases](https://github.com/amd/gaia/releases):
+
+- **Windows**: `gaia-ui-setup.exe`
+- **Ubuntu/Linux**: `gaia-ui-setup.deb`
+
+## Documentation
+
+- [Agent UI Guide](https://amd-gaia.ai/guides/agent-ui) — Full setup and usage guide
+- [Agent UI SDK Reference](https://amd-gaia.ai/sdk/sdks/agent-ui) — Backend API, models, endpoints
+- [GAIA Documentation](https://amd-gaia.ai) — Complete GAIA framework docs
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/amd/gaia.git
+cd gaia/src/gaia/apps/webui
+
+# Install dependencies
+npm install
+
+# Start dev server (proxies API to localhost:4200)
+npm run dev
+
+# Build for production
+npm run build
+```
+
+## License
+
+MIT — see [LICENSE](./LICENSE)

package/app.config.json

@@ -0,0 +1,37 @@
+{
+  "name": "agent-ui",
+  "displayName": "GAIA Agent UI",
+  "version": "0.1.0",
+  "description": "Privacy-first agentic AI interface with document Q&A - runs 100% locally on AMD Ryzen AI",
+  "author": "AMD AI Group",
+  "license": "MIT",
+  "window": {
+    "width": 1400,
+    "height": 900,
+    "minWidth": 900,
+    "minHeight": 700
+  },
+  "backend": {
+    "command": "gaia",
+    "args": ["chat", "--ui", "--ui-port", "4200"],
+    "port": 4200,
+    "healthCheck": "/api/health",
+    "startupTimeout": 15000
+  },
+  "devServer": {
+    "port": 4200,
+    "vitePort": 5174
+  },
+  "installer": {
+    "nsis": {
+      "oneClick": false,
+      "allowToChangeInstallationDirectory": true,
+      "installerIcon": "assets/icon.ico",
+      "uninstallerIcon": "assets/icon.ico",
+      "installerHeaderIcon": "assets/icon.ico"
+    },
+    "appId": "com.amd.gaia.agent-ui",
+    "productName": "GAIA Agent UI",
+    "copyright": "Copyright (C) 2025-2026 Advanced Micro Devices, Inc."
+  }
+}