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

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

pip install -U "agno[aws]"

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

export OPENAI_API_KEY=sk-***

​

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

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

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

​

Next

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