mirror of
https://github.com/MervinPraison/PraisonAIUI.git
synced 2026-11-08 08:11:08 -10:00
Mervin Praison
f40cf42345
Added detailed references for Python examples, outlining each example's unique concept and run instructions for better clarity and usability. Updated the examples README for improved navigation.
67 lines
2.2 KiB
Python
67 lines
2.2 KiB
Python
"""Dashboard — Admin panel with custom pages via @aiui.page.
|
|
|
|
What's New (vs agent-playground/):
|
|
• @page decorator — register custom dashboard pages
|
|
• @on("event") — alternative event-based callback syntax
|
|
• Data-driven pages with zero frontend code
|
|
• Protocol-driven provider system — swap any AI backend:
|
|
aiui.set_provider(MyProvider())
|
|
|
|
Run:
|
|
aiui run app.py --style dashboard
|
|
"""
|
|
import praisonaiui as aiui
|
|
|
|
# Register some agents for the dashboard to display
|
|
@aiui.on("profiles")
|
|
def profiles():
|
|
return [
|
|
{"name": "Code Expert", "description": "Code review & generation"},
|
|
{"name": "Data Analyst", "description": "Data analysis & visualization"},
|
|
]
|
|
|
|
@aiui.on("reply")
|
|
def reply(message):
|
|
return f"Echo: {message}"
|
|
|
|
|
|
# ---------- Protocol-driven custom page ----------
|
|
# This demonstrates how users can add their own dashboard pages
|
|
# with just a decorator and a function — zero frontend code needed.
|
|
|
|
@aiui.page("metrics", title="My Metrics", icon="📊", group="Analytics",
|
|
description="Custom analytics dashboard")
|
|
async def metrics_page():
|
|
"""Data handler for the custom Metrics page.
|
|
Returns a dict that the frontend renders automatically."""
|
|
return {
|
|
"total_users": 1_234,
|
|
"active_today": 42,
|
|
"revenue": "$12,345",
|
|
"kpis": [
|
|
{"label": "Conversion Rate", "value": "3.2%"},
|
|
{"label": "Avg Response Time", "value": "1.2s"},
|
|
{"label": "Uptime", "value": "99.9%"},
|
|
],
|
|
"top_models": {
|
|
"gpt-4o": "1,200 requests",
|
|
"claude-3.5": "800 requests",
|
|
"llama-3": "300 requests",
|
|
},
|
|
}
|
|
|
|
|
|
@aiui.page("getting-started", title="Getting Started", icon="🚀",
|
|
group="Docs", description="Quick start guide", order=20)
|
|
async def docs_page():
|
|
"""@page works for documentation content too — not just analytics."""
|
|
return {
|
|
"title": "Getting Started with PraisonAIUI",
|
|
"sections": [
|
|
{"heading": "Installation", "content": "pip install praisonaiui"},
|
|
{"heading": "First App", "content": "@aiui.reply → aiui.say()"},
|
|
{"heading": "Dashboard", "content": "@aiui.page() for custom pages"},
|
|
],
|
|
}
|
|
|