Agent API: FastAPI and Postgres

The Agent API workspace provides a simple RestAPI + database for serving agents. It contains:

A FastAPI server for serving Agents, Teams and Workflows.
A postgres database for session and vector storage.

Setup

Create and activate a virtual environment

python3 -m venv .venv
source .venv/bin/activate

python3 -m venv aienv
aienv/scripts/activate

Install Agno

pip install -U "agno[aws]"

pip install -U "agno[aws]"

Install uv and docker

Install uv for managing your python environment.

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

Install docker desktop to run your app locally

Export your OpenAI key

export OPENAI_API_KEY=sk-***

setx OPENAI_API_KEY sk-***

Agno is compatible with any model provider; simply update the agents in the workspace.

Create your Agent API codebase

Create your codebase using the agent-api template, give it any name you like.

ag ws create --template agent-api --name agent-api

ag ws create --template agent-api --name agent-api

This will create a folder agent-api with the following structure:

agent-api                     # root directory
├── agents                  # add your Agents here
├── api                     # add fastApi routes here
├── db                      # add database tables here
├── Dockerfile              # Dockerfile for the application
├── pyproject.toml          # python project definition
├── requirements.txt        # python dependencies generated by pyproject.toml
├── scripts                 # helper scripts
├── utils                   # shared utilities
└── workspace               # agno workspace directory
    ├── dev_resources.py    # dev resources running locally
    ├── prd_resources.py    # production resources running on AWS
    ├── secrets             # secrets
    └── settings.py         # agno workspace settings

Run your Agent Api locally

cd into the agent-api folder

cd agent-api

Start your Agent Api using the following command:

ag ws up

ag ws up dev:docker

ag ws up --env dev --infra docker

Press Enter to confirm and give a few seconds for the image to download (only the first time). Verify container status and view logs on the docker dashboard.

Open localhost:8000/docs to view the FastAPI routes.

Notes:

The Agents are defined in the agents folder.
The api routes are defined in the api folder.

Stop local workspace

Play around and stop the workspace using:

ag ws down

ag ws down --env dev --infra docker

ag ws down dev:docker

Congratulations on running your Agent API locally. Next Steps:

Run your Agent API on AWS
Read how to update workspace settings
Read how to create a git repository for your workspace
Read how to manage the development application
Read how to format and validate your code
Read how to add python libraries
Chat with us on discord

Workspaces

Workspace Management

Agent API: FastAPI and Postgres

Setup

Create your Agent API codebase

Run your Agent Api locally

Stop local workspace

Next

​Setup

​Create your Agent API codebase

​Run your Agent Api locally

​Stop local workspace

​Next

Setup

Create your Agent API codebase

Run your Agent Api locally

Stop local workspace

Next