50 lines
1.7 KiB
Markdown
50 lines
1.7 KiB
Markdown
# AgentOS: Visual Observability & Command Center
|
|
|
|
AgentOS is a real-time observability and command center for the TradingAgents framework. It provides a visual interface to monitor multi-agent workflows, analyze portfolio risk metrics, and trigger automated trading pipelines.
|
|
|
|
## System Architecture
|
|
|
|
- **Backend:** FastAPI (Python)
|
|
- Orchestrates LangGraph executions.
|
|
- Streams real-time events via WebSockets.
|
|
- Serves portfolio data from Supabase.
|
|
- Port: `8088` (default)
|
|
- **Frontend:** React (TypeScript) + Vite
|
|
- Visualizes agent workflows using React Flow.
|
|
- Displays high-fidelity risk metrics (Sharpe, Regime, Drawdown).
|
|
- Provides a live terminal for deep tracing.
|
|
- Port: `5173` (default)
|
|
|
|
## Getting Started
|
|
|
|
### 1. Prerequisites
|
|
- Python 3.10+
|
|
- Node.js 18+
|
|
- [uv](https://github.com/astral-sh/uv) (recommended for Python environment management)
|
|
|
|
### 2. Backend Setup
|
|
```bash
|
|
# From the project root
|
|
export PYTHONPATH=$PYTHONPATH:.
|
|
uv run python agent_os/backend/main.py
|
|
```
|
|
The backend will start on `http://127.0.0.1:8088`.
|
|
|
|
### 3. Frontend Setup
|
|
```bash
|
|
cd agent_os/frontend
|
|
npm install
|
|
npm run dev
|
|
```
|
|
The frontend will start on `http://localhost:5173`.
|
|
|
|
## Key Features
|
|
|
|
- **Literal Graph Visualization:** Real-time DAG rendering of agent interactions.
|
|
- **Top 3 Metrics:** High-level summary of Sharpe Ratio, Market Regime, and Risk/Drawdown.
|
|
- **Live Terminal:** Color-coded logs with token usage and latency metrics.
|
|
- **Run Controls:** Trigger Market Scans, Analysis Pipelines, and Portfolio Rebalancing directly from the UI.
|
|
|
|
## Port Configuration
|
|
AgentOS uses port **8088** for the backend to avoid conflicts with common macOS services. The frontend is configured to communicate with `127.0.0.1:8088`.
|