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 local development environment using Overmind (recommended)
2. A development environment running locally on docker

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

This method runs all services directly on your local machine without Docker.

1. Install PostgreSQL 17 and pgvector:

brew install postgresql@17 pgvector

# Configure PostgreSQL 17 to run on port 5433 (to avoid conflict with PostgreSQL 16)
echo "port = 5433" >> /opt/homebrew/var/postgresql@17/postgresql.conf

# Start PostgreSQL 17
brew services start postgresql@17

2. Install Overmind:

brew install overmind

3. Create and configure environment variables:

cp .env.example .env
# Edit .env file with your API keys and update DB_PORT=5433 for PostgreSQL 17 (if you have another version of postgres on your machine, otherwise you can use the standard 5432)

4. Set up the database:

# Create database using PostgreSQL 17 (specify port 5433 to avoid conflict with PostgreSQL 16)
/opt/homebrew/opt/postgresql@17/bin/createdb -p 5433 opt_out_dev

# Connect to the database and enable pgvector extension
psql -p 5433 opt_out_dev -c "CREATE EXTENSION IF NOT EXISTS vector;"

5. Run database migrations:

uv run alembic -c db/alembic.ini upgrade head

overmind start

This will start:

• FastAPI server on localhost:8000
• Streamlit UI on localhost:8501

overmind stop

Or press Ctrl+C in the terminal running Overmind.

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 supported model provider, just need to update the respective Agent, Team or Workflow.

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

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