Web Interface

Web UI Tour

Explore the Faramesh web interface. A clean, modern interface for monitoring and managing AI agent actions in real-time.

Accessing the UI

Once the server is running, open http://127.0.0.1:8000 in your browser.

Theme

The UI features Dark Mode by default with brand colors. You can toggle to Light Mode using the toggle button in the header.

Action List Table

The main view displays all actions in a comprehensive table

ID
Unique action identifier (truncated for readability)
Agent
Agent ID that submitted the action
Tool
Tool name (e.g., "shell", "http", "stripe")
Operation
Operation type (e.g., "run", "get", "refund")
Status
Current action status with color-coded badges
Created
Timestamp when action was created

Powerful Filtering

Filter and search actions with multiple criteria

Status Filter
Filter by action status (pending_approval, allowed, denied, etc.)
Agent Filter
Filter by agent ID
Tool Filter
Filter by tool name
Search
Search across tool, operation, agent, reason, and risk level

Filters can be combined to narrow down the action list.

Action Details Modal

Click any row in the table to open the action details modal. The modal shows:

  • Full action parameters
  • Policy decision and reason
  • Risk level
  • Execution result (if completed)
  • Timestamps for each status change

Approve/Deny Buttons

For actions with status pending_approval, the modal displays:

  • Approve button - Allows the action to proceed
  • Deny button - Blocks the action

Both buttons require the approval token for security.

Real-Time Updates

Live updates via Server-Sent Events (SSE)

The UI uses Server-Sent Events (SSE) for live updates:

New actions appear automatically
Status changes update in real-time
No page refresh needed
Event Types:
action.created
action.approved
action.denied
action.completed

Auto-Refresh Toggle

The UI includes an auto-refresh toggle that:

  • Refreshes the action list every 5 seconds when enabled
  • Shows current refresh status
  • Can be toggled on/off as needed

Metrics & Observability

Prometheus metrics available at /metrics endpoint

actions_totalTotal number of actions by status
errors_totalTotal number of errors
latencyAction processing latency

Policies

Learn how to write policies to control agent actions.

View Policies→

Self-Hosting

Deploy FaraCore in production with PostgreSQL and reverse proxy.

View Guide→
Previous
Concepts
Next
Policies Overview