File size: 2,091 Bytes
3e30d53 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 | # Aegis Deployment Guide
This guide explains how to deploy the Aegis Financial Analyst Agent using Docker and Docker Compose.
## Prerequisites
- **Docker** and **Docker Compose** installed on your machine.
- An `.env` file with valid API keys (see `.env.example` or your existing `.env`).
## Deployment Steps
1. **Build and Start Services**
Run the following command in the project root directory:
```bash
docker-compose up --build -d
```
This will:
- Build the Docker image for the application.
- Create a network `aegis-net`.
- Start all services (Gateway, Microservices, Monitor, Frontend) in detached mode.
2. **Verify Deployment**
- **Frontend**: Access the Streamlit UI at `http://localhost:8501`.
- **Gateway**: `http://localhost:8000`
- **Services**:
- Tavily: `http://localhost:8001`
- Alpha Vantage: `http://localhost:8002`
- Portfolio: `http://localhost:8003`
3. **View Logs**
To see logs for all services:
```bash
docker-compose logs -f
```
To see logs for a specific service (e.g., frontend):
```bash
docker-compose logs -f frontend
```
4. **Stop Services**
To stop and remove containers:
```bash
docker-compose down
```
## Environment Variables
Ensure your `.env` file contains:
- `GOOGLE_API_KEY`
- `TAVILY_API_KEY`
- `ALPHA_VANTAGE_API_KEY`
Docker Compose automatically reads these from the `.env` file in the same directory.
## Alternative Deployment (No Docker)
If you cannot run Docker, use the local deployment script:
```bash
./deploy_local.sh
```
This runs all services in the background and saves logs to a `logs/` folder.
## Troubleshooting
- **"Cannot connect to the Docker daemon"**: This means Docker is not running. Open **Docker Desktop** on your Mac and wait for it to start (the whale icon in the menu bar should stop animating).
- **Port Conflicts**: Ensure ports 8000-8003 and 8501 are free.
- **Database Persistence**: The `portfolio.db` file is mounted as a volume, so your internal portfolio data persists across restarts.
|