Agent App

This repo contains the code for a production-grade agentic system built with:

1. A Streamlit UI
2. A FastAPI server
3. A Postgres database with the PgVector extension.

You can run the agent app in 2 environments:

1. A development environment running locally on docker
2. A production environment running on AWS ECS

Setup

1. Install uv for managing the python environment.

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Create a virtual environment and install dependencies:

./scripts/dev_setup.sh

3. Activate virtual environment

source .venv/bin/activate

Run application locally using docker

1. Install docker desktop

2. Export API keys

Required: Set the OPENAI_API_KEY environment variable using

export OPENAI_API_KEY=***

you may use any model provider, just need to update the agents in the /agents folder

Optional: Set the EXA_API_KEY if you'd like to use Exa search

export EXA_API_KEY=***

3. Start the workspace:

ag ws up

• This will run 3 containers:
  • Streamlit on localhost:8501
  • FastAPI on localhost:8000
  • Postgres on localhost:5432
• Open localhost:8501 to view the Streamlit App.
• Open localhost:8000/docs to view the FastAPI docs.

4. Stop the workspace using:

ag ws down

More Information

Learn more about this application and how to customize it in the Agno Workspaces documentaion