Agno Agent

A series of AI agents built using the Agno framework

Setup

This project uses uv for Python dependency management.

Prerequisites

• Python 3.12+
• uv package manager
• OpenAI API key

Install uv

We use uv for python environment and package management. Install it by following the the uv documentation or use the command below for unix-like systems:

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

Installation

1. Clone the repository

2. Setup your virtual environment:

   uv venv --python 3.12
   source .venv/bin/activate

3. Install dependencies:

   uv sync

Configuration

Set your OpenAI API key as an environment variable:

export OPENAI_API_KEY=="your-oepnai-api-key"

Code Formatting

This project uses black for code formatting and isort for import sorting, both configured in pyproject.toml.

Format code and sort imports (recommended):

uv run black . && uv run isort .

Check formatting and import sorting without making changes:

uv run black --check . && uv run isort --check-only .

Show formatting and import sorting diff without making changes:

uv run black --diff . && uv run isort --diff .

Usage

Run the different agent levels:

Level 1: Agents with tools and instructions

uv run python agent/sample/level_1_agent.py

Level 2: Agents with knowledge and storage

uv run python agent/sample/level_2_agent.py

Level 3: Agents with memory and reasoning

uv run python agent/sample/level_3_agent.py

Level 4: Agent Teams that can reason and collaborate

uv run python agent/sample/level_4_team.py

Level 5: Agentic Workflows with state and determinism

uv run python agent/sample/level_5_workflow.py

Run Research Agent

uv run python agent/sample/research_agent.py

Run Playground Server Locally

uv run python playground/playground.py

Project Structure

• agent/ - Contains all agent implementations
  • sample/ - Sample agent implementations demonstrating different levels and features
  • healthcare/ - Healthcare Agent MVP implementation
  • memory/ - Memory management examples
  • session_state/ - Session state management examples
  • tool/ - Custom tool implementations
• playground/ - Contains playground server
• pyproject.toml - Project configuration and dependencies
• .python-version - Python version specification