Skip to main content

Getting Started

Prerequisites

  • Python version >=3.10
  • A Maxim account (sign up here)
  • Generate Maxim API Key
  • An Agno project

Installation

Install the Maxim SDK via pip:
Or add it to your requirements.txt:

Basic Setup

1. Set up environment variables

2. Import the required packages

3. Initialise Maxim with your API key

4. Create and run your Agno application as usual

That’s it! All your Agno agent interactions will now be logged and available in your Maxim dashboard. Check this Cookbook for a quick reference - Notebook

Multi-Agent Example

Here’s how to set up a multi-agent system with Maxim integration:

Viewing Your Traces

After running your Agno application:
  1. Log in to your Maxim Dashboard
  2. Navigate to your repository
  3. View detailed agent traces, including:
    • Agent conversations
    • Tool usage patterns
    • Performance metrics
    • Cost analytics
    • Token usage
    • Model information
agno.gif

Troubleshooting

Common Issues

  • No traces appearing: Ensure your API key and repository ID are correct
  • Ensure you’ve called instrument_agno() before running your agents. This initializes logging hooks correctly.
  • Set debug=True in your instrument_agno() call to surface any internal errors:
  • Double-check that instrument_agno() is called before creating or executing agents. This might be obvious, but it’s a common oversight.

Debug Mode

Enable debug mode to see detailed logging information:

Resources

Agno Docs

Official Agno documentation

Maxim Docs

Official Maxim documentation

Maxim Github

Official Maxim GitHub repository