add frontend
This commit is contained in:
Marvin Gabler
parent
a0710f5558
commit
2b37cddd1d
BIN
api_database.db
BIN
api_database.db
Binary file not shown.
|
|
@ -0,0 +1,31 @@
|
|||
# Logs
|
||||
logs
|
||||
*.log
|
||||
npm-debug.log*
|
||||
yarn-debug.log*
|
||||
yarn-error.log*
|
||||
pnpm-debug.log*
|
||||
lerna-debug.log*
|
||||
|
||||
node_modules
|
||||
dist
|
||||
dist-ssr
|
||||
*.local
|
||||
|
||||
# Editor directories and files
|
||||
.vscode/*
|
||||
!.vscode/extensions.json
|
||||
.idea
|
||||
.DS_Store
|
||||
*.suo
|
||||
*.ntvs*
|
||||
*.njsproj
|
||||
*.sln
|
||||
*.sw?
|
||||
|
||||
# Environment variables
|
||||
.env
|
||||
.env.local
|
||||
.env.production.local
|
||||
.env.development.local
|
||||
.env.test.local
|
||||
|
|
@ -0,0 +1,183 @@
|
|||
# Trading Agents Terminal Frontend
|
||||
|
||||
A React-based terminal/ASCII-style frontend for the Trading Agents multi-agent trading analysis system.
|
||||
|
||||
## Features
|
||||
|
||||
- **Terminal-Inspired UI**: Bloomberg Terminal-style interface with ASCII aesthetics
|
||||
- **Real-Time Updates**: WebSocket integration for live analysis progress
|
||||
- **Agent Pipeline Visualization**: Visual representation of the multi-agent workflow
|
||||
- **Analysis Management**: Create, monitor, and manage trading analyses
|
||||
- **Report Viewer**: View and download analysis reports
|
||||
- **Log Viewer**: Real-time execution logs with filtering
|
||||
|
||||
## Tech Stack
|
||||
|
||||
- **React 18** with TypeScript
|
||||
- **Vite** for fast development
|
||||
- **Tailwind CSS** with custom terminal theme
|
||||
- **TanStack Query** (React Query) for data fetching
|
||||
- **Zustand** for state management
|
||||
- **React Router** for navigation
|
||||
- **Lucide React** for icons
|
||||
- **Framer Motion** for animations
|
||||
|
||||
## Getting Started
|
||||
|
||||
### Prerequisites
|
||||
|
||||
- Node.js 16+
|
||||
- npm or yarn
|
||||
- Trading Agents API server running (default: http://localhost:8002)
|
||||
|
||||
### Installation
|
||||
|
||||
```bash
|
||||
# Install dependencies
|
||||
npm install
|
||||
|
||||
# Start development server
|
||||
npm run dev
|
||||
```
|
||||
|
||||
The application will be available at http://localhost:5173
|
||||
|
||||
### Configuration
|
||||
|
||||
Create a `.env` file:
|
||||
|
||||
```
|
||||
VITE_API_URL=http://localhost:8002
|
||||
```
|
||||
|
||||
### First Time Setup
|
||||
|
||||
1. Navigate to the Settings page
|
||||
2. Enter your API key (get one from the API server)
|
||||
3. Configure the API URL if different from default
|
||||
4. Start creating analyses!
|
||||
|
||||
## Project Structure
|
||||
|
||||
```
|
||||
src/
|
||||
├── components/
|
||||
│ ├── layout/ # Header, Sidebar, StatusBar, Layout
|
||||
│ ├── ui/ # Reusable UI components (ASCIIBox, Button, etc.)
|
||||
│ ├── analysis/ # Analysis-related components
|
||||
│ ├── agents/ # Agent pipeline visualization
|
||||
│ └── dashboard/ # Dashboard components
|
||||
├── pages/ # Page components
|
||||
├── hooks/ # Custom React hooks
|
||||
├── services/ # API and WebSocket services
|
||||
├── stores/ # Zustand stores
|
||||
├── types/ # TypeScript type definitions
|
||||
├── utils/ # Utility functions
|
||||
└── styles/ # Global styles
|
||||
```
|
||||
|
||||
## Available Scripts
|
||||
|
||||
```bash
|
||||
# Development server
|
||||
npm run dev
|
||||
|
||||
# Build for production
|
||||
npm run build
|
||||
|
||||
# Preview production build
|
||||
npm run preview
|
||||
|
||||
# Type checking
|
||||
npm run type-check
|
||||
|
||||
# Linting
|
||||
npm run lint
|
||||
```
|
||||
|
||||
## Features Guide
|
||||
|
||||
### Dashboard
|
||||
|
||||
- System metrics overview
|
||||
- Recent activity feed
|
||||
- Quick links to common actions
|
||||
|
||||
### Analysis Management
|
||||
|
||||
- Create new analyses with custom parameters
|
||||
- View all analyses in a sortable table
|
||||
- Real-time status updates
|
||||
- Detailed analysis view with agent pipeline
|
||||
|
||||
### Real-Time Monitoring
|
||||
|
||||
- WebSocket connection for live updates
|
||||
- Agent pipeline progress visualization
|
||||
- Live log streaming
|
||||
- Progress bars and status indicators
|
||||
|
||||
### Reports
|
||||
|
||||
- Tabbed interface for different report types
|
||||
- Markdown rendering
|
||||
- Copy to clipboard
|
||||
- Download as text file
|
||||
|
||||
### Settings
|
||||
|
||||
- API key configuration
|
||||
- API URL configuration
|
||||
- Application information
|
||||
|
||||
## Styling
|
||||
|
||||
The application uses a custom terminal/ASCII theme with:
|
||||
|
||||
- Green (#00ff00) - Primary color
|
||||
- Cyan (#00ffff) - Accent color
|
||||
- Yellow (#ffff00) - Warning color
|
||||
- Red (#ff0000) - Error color
|
||||
- Dark background (#0a0e14)
|
||||
|
||||
All components follow the ASCII/terminal aesthetic with box-drawing characters and monospace fonts.
|
||||
|
||||
## Development
|
||||
|
||||
### Adding New Pages
|
||||
|
||||
1. Create page component in `src/pages/`
|
||||
2. Add route in `src/App.tsx`
|
||||
3. Add navigation link in `src/components/layout/Sidebar.tsx`
|
||||
|
||||
### Adding New Components
|
||||
|
||||
1. Create component in appropriate directory under `src/components/`
|
||||
2. Use existing UI components for consistency
|
||||
3. Follow terminal styling conventions
|
||||
|
||||
### API Integration
|
||||
|
||||
All API calls go through `src/services/api.ts`. Use the custom hooks in `src/hooks/` for data fetching:
|
||||
|
||||
```typescript
|
||||
import { useAnalyses } from '../hooks/useAnalyses';
|
||||
|
||||
const { data, isLoading } = useAnalyses();
|
||||
```
|
||||
|
||||
## Deployment
|
||||
|
||||
```bash
|
||||
# Build for production
|
||||
npm run build
|
||||
|
||||
# Preview the build
|
||||
npm run preview
|
||||
```
|
||||
|
||||
The built files will be in the `dist/` directory. Deploy to any static hosting service (Vercel, Netlify, etc.).
|
||||
|
||||
## License
|
||||
|
||||
Part of the Trading Agents project.
|
||||
|
|
@ -0,0 +1,110 @@
|
|||
# Trading Agents Frontend - Quick Start
|
||||
|
||||
## Quick Start
|
||||
|
||||
### 1. Install Dependencies (First Time Only)
|
||||
|
||||
```bash
|
||||
cd frontend
|
||||
npm install
|
||||
```
|
||||
|
||||
### 2. Start Development Server
|
||||
|
||||
```bash
|
||||
npm run dev
|
||||
```
|
||||
|
||||
The frontend will be available at: **http://localhost:5173**
|
||||
|
||||
### 3. Configure API Connection
|
||||
|
||||
1. Navigate to http://localhost:5173/settings
|
||||
2. Enter your API key from the backend
|
||||
3. Verify the API URL is correct (default: http://localhost:8002)
|
||||
|
||||
**Note:** Make sure the Trading Agents API is running on port 8002 before using the frontend!
|
||||
|
||||
## First Time Setup
|
||||
|
||||
When you first open the application:
|
||||
|
||||
1. You'll be automatically redirected to the Settings page
|
||||
2. Enter the API key you received when starting the API server
|
||||
3. The API key is stored securely in your browser's local storage
|
||||
4. Once configured, you can start creating analyses!
|
||||
|
||||
## Available Commands
|
||||
|
||||
```bash
|
||||
# Development server (with hot reload)
|
||||
npm run dev
|
||||
|
||||
# Build for production
|
||||
npm run build
|
||||
|
||||
# Preview production build
|
||||
npm run preview
|
||||
|
||||
# Type checking
|
||||
npm run type-check
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
**"Invalid or inactive API key"**
|
||||
- Go to Settings and verify your API key
|
||||
- Make sure you copied the entire key from the API startup logs
|
||||
- Check that the API server is running
|
||||
|
||||
**"Cannot connect to API"**
|
||||
- Verify the API URL in Settings (default: http://localhost:8002)
|
||||
- Make sure the API server is running
|
||||
- Check for port conflicts
|
||||
|
||||
**Frontend not loading**
|
||||
- Check that port 5173 is not in use
|
||||
- Try stopping the dev server and starting again
|
||||
- Clear browser cache and reload
|
||||
|
||||
## Development Tips
|
||||
|
||||
- The frontend uses hot module replacement (HMR) for instant updates
|
||||
- Changes to TypeScript files will cause a rebuild
|
||||
- Changes to CSS will update instantly
|
||||
- Browser DevTools are your friend for debugging
|
||||
|
||||
## Project Structure
|
||||
|
||||
```
|
||||
frontend/
|
||||
├── src/
|
||||
│ ├── components/ # React components
|
||||
│ ├── pages/ # Page components
|
||||
│ ├── hooks/ # Custom hooks
|
||||
│ ├── services/ # API & WebSocket
|
||||
│ ├── stores/ # State management
|
||||
│ ├── types/ # TypeScript types
|
||||
│ ├── utils/ # Utilities
|
||||
│ └── styles/ # Global styles
|
||||
├── public/ # Static assets
|
||||
└── index.html # Entry HTML
|
||||
```
|
||||
|
||||
## Features
|
||||
|
||||
- **Dashboard**: Overview of all analyses and system metrics
|
||||
- **Analyses**: List and manage all trading analyses
|
||||
- **Create Analysis**: Form to start new analysis
|
||||
- **Analysis Detail**: Real-time view of analysis progress
|
||||
- **Settings**: Configure API key and URL
|
||||
|
||||
## Next Steps
|
||||
|
||||
1. Start the API server (see `api/START_API.md`)
|
||||
2. Start the frontend (`npm run dev`)
|
||||
3. Configure your API key in Settings
|
||||
4. Create your first analysis!
|
||||
|
||||
Enjoy using Trading Agents! 🚀
|
||||
|
||||
|
|
@ -0,0 +1,23 @@
|
|||
import js from '@eslint/js'
|
||||
import globals from 'globals'
|
||||
import reactHooks from 'eslint-plugin-react-hooks'
|
||||
import reactRefresh from 'eslint-plugin-react-refresh'
|
||||
import tseslint from 'typescript-eslint'
|
||||
import { defineConfig, globalIgnores } from 'eslint/config'
|
||||
|
||||
export default defineConfig([
|
||||
globalIgnores(['dist']),
|
||||
{
|
||||
files: ['**/*.{ts,tsx}'],
|
||||
extends: [
|
||||
js.configs.recommended,
|
||||
tseslint.configs.recommended,
|
||||
reactHooks.configs['recommended-latest'],
|
||||
reactRefresh.configs.vite,
|
||||
],
|
||||
languageOptions: {
|
||||
ecmaVersion: 2020,
|
||||
globals: globals.browser,
|
||||
},
|
||||
},
|
||||
])
|
||||
|
|
@ -0,0 +1,13 @@
|
|||
<!doctype html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="UTF-8" />
|
||||
<link rel="icon" type="image/png" href="/litadel.png" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||
<title>Litadel - Multi-Agent Trading System</title>
|
||||
</head>
|
||||
<body>
|
||||
<div id="root"></div>
|
||||
<script type="module" src="/src/main.tsx"></script>
|
||||
</body>
|
||||
</html>
|
||||
File diff suppressed because it is too large
Load Diff
|
|
@ -0,0 +1,42 @@
|
|||
{
|
||||
"name": "frontend",
|
||||
"private": true,
|
||||
"version": "0.0.0",
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"dev": "vite",
|
||||
"build": "tsc -b && vite build",
|
||||
"lint": "eslint .",
|
||||
"preview": "vite preview"
|
||||
},
|
||||
"dependencies": {
|
||||
"@tailwindcss/postcss": "^4.1.15",
|
||||
"@tanstack/react-query": "^5.90.5",
|
||||
"autoprefixer": "^10.4.21",
|
||||
"axios": "^1.12.2",
|
||||
"framer-motion": "^12.23.24",
|
||||
"lucide-react": "^0.546.0",
|
||||
"postcss": "^8.5.6",
|
||||
"react": "^19.1.1",
|
||||
"react-dom": "^19.1.1",
|
||||
"react-hot-toast": "^2.6.0",
|
||||
"react-router-dom": "^7.9.4",
|
||||
"recharts": "^3.3.0",
|
||||
"tailwindcss": "^4.1.15",
|
||||
"zustand": "^5.0.8"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@eslint/js": "^9.36.0",
|
||||
"@types/node": "^24.6.0",
|
||||
"@types/react": "^19.1.16",
|
||||
"@types/react-dom": "^19.1.9",
|
||||
"@vitejs/plugin-react": "^5.0.4",
|
||||
"eslint": "^9.36.0",
|
||||
"eslint-plugin-react-hooks": "^5.2.0",
|
||||
"eslint-plugin-react-refresh": "^0.4.22",
|
||||
"globals": "^16.4.0",
|
||||
"typescript": "~5.9.3",
|
||||
"typescript-eslint": "^8.45.0",
|
||||
"vite": "^7.1.7"
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,7 @@
|
|||
export default {
|
||||
plugins: {
|
||||
'@tailwindcss/postcss': {},
|
||||
autoprefixer: {},
|
||||
},
|
||||
}
|
||||
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 120 KiB |
|
|
@ -0,0 +1 @@
|
|||
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>
|
||||
|
After Width: | Height: | Size: 1.5 KiB |
|
|
@ -0,0 +1,28 @@
|
|||
{
|
||||
"compilerOptions": {
|
||||
"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
|
||||
"target": "ES2022",
|
||||
"useDefineForClassFields": true,
|
||||
"lib": ["ES2022", "DOM", "DOM.Iterable"],
|
||||
"module": "ESNext",
|
||||
"types": ["vite/client"],
|
||||
"skipLibCheck": true,
|
||||
|
||||
/* Bundler mode */
|
||||
"moduleResolution": "bundler",
|
||||
"allowImportingTsExtensions": true,
|
||||
"verbatimModuleSyntax": true,
|
||||
"moduleDetection": "force",
|
||||
"noEmit": true,
|
||||
"jsx": "react-jsx",
|
||||
|
||||
/* Linting */
|
||||
"strict": true,
|
||||
"noUnusedLocals": true,
|
||||
"noUnusedParameters": true,
|
||||
"erasableSyntaxOnly": true,
|
||||
"noFallthroughCasesInSwitch": true,
|
||||
"noUncheckedSideEffectImports": true
|
||||
},
|
||||
"include": ["src"]
|
||||
}
|
||||
|
|
@ -0,0 +1,7 @@
|
|||
{
|
||||
"files": [],
|
||||
"references": [
|
||||
{ "path": "./tsconfig.app.json" },
|
||||
{ "path": "./tsconfig.node.json" }
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,26 @@
|
|||
{
|
||||
"compilerOptions": {
|
||||
"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
|
||||
"target": "ES2023",
|
||||
"lib": ["ES2023"],
|
||||
"module": "ESNext",
|
||||
"types": ["node"],
|
||||
"skipLibCheck": true,
|
||||
|
||||
/* Bundler mode */
|
||||
"moduleResolution": "bundler",
|
||||
"allowImportingTsExtensions": true,
|
||||
"verbatimModuleSyntax": true,
|
||||
"moduleDetection": "force",
|
||||
"noEmit": true,
|
||||
|
||||
/* Linting */
|
||||
"strict": true,
|
||||
"noUnusedLocals": true,
|
||||
"noUnusedParameters": true,
|
||||
"erasableSyntaxOnly": true,
|
||||
"noFallthroughCasesInSwitch": true,
|
||||
"noUncheckedSideEffectImports": true
|
||||
},
|
||||
"include": ["vite.config.ts"]
|
||||
}
|
||||
|
|
@ -0,0 +1,7 @@
|
|||
import { defineConfig } from 'vite'
|
||||
import react from '@vitejs/plugin-react'
|
||||
|
||||
// https://vite.dev/config/
|
||||
export default defineConfig({
|
||||
plugins: [react()],
|
||||
})
|
||||
Loading…
Reference in New Issue