deployment_guide.md

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:

   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:

   docker-compose logs -f
   

   To see logs for a specific service (e.g., frontend):

   docker-compose logs -f frontend
   

4. Stop Services To stop and remove containers:

   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:

./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.