Skip to main content
Math agents evaluate expressions, solve equations, convert units, and run statistical or financial calculations through specialised tools on a single Agent. 
from praisonaiagents import Agent

agent = Agent(name="Math Tutor", instructions="Solve math problems step by step.")
agent.start("What is 15 percent of 240?")
The user asks a quantitative question; the math agent selects the right calculation tools and returns a clear answer.

​
How It Works

​
Quick Start

1

Install Package

First, install the PraisonAI Agents package:
pip install praisonaiagents sympy pint
2

Set API Key

Set your OpenAI API key as an environment variable in your terminal:
export OPENAI_API_KEY="${OPENAI_API_KEY:?Set OPENAI_API_KEY in your shell}"
3

Create a file

Create a new file app.py with the basic setup:
from praisonaiagents import Agent, Task, AgentTeam
from praisonaiagents import (
    evaluate, solve_equation, convert_units,
    calculate_statistics, calculate_financial
)

# Create math agent
math_agent = Agent(
    role="Math Expert",
    goal="Perform complex mathematical calculations",
    backstory="Expert in mathematical computations and analysis",
    tools=[
        evaluate, solve_equation, convert_units,
        calculate_statistics, calculate_financial
    ],
    
)

# Create a task
task = Task(
    description="Calculate compound interest and statistical analysis",
    expected_output="Detailed mathematical analysis",
    agent=math_agent
)

# Create and start the agents
agents = AgentTeam(
    agents=[math_agent],
    tasks=[task],
    process="sequential",
    verbose=2
)

# Start execution
agents.start()
4

Start Agents

Type this in your terminal to run your agents:
python app.py
Requirements
  • Python 3.10 or higher
  • OpenAI API key. Generate OpenAI API key here. Use Other models using this guide.
  • sympy and pint packages (automatically installed when needed)

​
Understanding Math Agents

What are Math Agents?

Math agents are specialized AI agents that can:
  • Evaluate mathematical expressions
  • Solve equations and systems of equations
  • Perform unit conversions
  • Calculate statistical metrics
  • Handle financial calculations

​
Features

Expression Evaluator

Evaluates mathematical expressions and formulas.

Equation Solver

Solves mathematical equations and systems.

Unit Converter

Converts between different units of measurement.

Statistical Calculator

Calculates statistical metrics and analysis.

​
Multi-Agent AI Math Analysis

1

Install Package

First, install the PraisonAI Agents package:
pip install praisonaiagents
2

Set API Key

Set your OpenAI API key as an environment variable in your terminal:
export OPENAI_API_KEY="${OPENAI_API_KEY:?Set OPENAI_API_KEY in your shell}"
3

Create a file

Create a new file app.py with the basic setup:
from praisonaiagents import Agent, Task, AgentTeam
from praisonaiagents import (
    evaluate, solve_equation, convert_units,
    calculate_statistics, calculate_financial
)

# Create first agent for calculations
calculator = Agent(
    role="Mathematical Calculator",
    goal="Perform complex calculations and analysis",
    backstory="Expert in mathematical computations",
    tools=[evaluate, solve_equation, convert_units],
    
)

# Create second agent for statistics
statistician = Agent(
    role="Statistical Analyst",
    goal="Perform statistical analysis and interpretation",
    backstory="Expert in statistical analysis",
    tools=[calculate_statistics, calculate_financial],
    
)

# Create first task
calc_task = Task(
    description="Calculate compound interest for $10000 at 5% for 3 years",
    expected_output="Detailed interest calculation",
    agent=calculator
)

# Create second task
stats_task = Task(
    description="Analyze the monthly interest distribution",
    expected_output="Statistical analysis of interest data",
    agent=statistician
)

# Create and start the agents
agents = AgentTeam(
    agents=[calculator, statistician],
    tasks=[calc_task, stats_task],
    process="sequential"
)

# Start execution
agents.start()
4

Start Agents

Type this in your terminal to run your agents:
python app.py

​
Configuration Options

# Create an agent with advanced math configuration
agent = Agent(
    role="Math Expert",
    goal="Perform complex mathematical analysis",
    backstory="Expert in mathematical computations",
    tools=[
        evaluate,
        solve_equation,
        convert_units,
        calculate_statistics,
        calculate_financial
    ],
      # Enable detailed logging
    llm="gpt-4o"  # Language model to use
)

​
Best Practices

Give calculation agents evaluate and solve_equation; reserve calculate_statistics and calculate_financial for analysis agents.
State the formula, units, and expected output format in each Task so the agent picks the right tool.
Ensure input values include compatible units — convert_units fails on mismatched dimensions.

​
Troubleshooting

Expression Errors

If expressions are not evaluating:
  • Check syntax and formatting
  • Verify variable definitions
  • Enable verbose mode for debugging

Calculation Issues

If calculations are incorrect:
  • Review input formats
  • Check unit compatibility
  • Verify formula structure

​
Next Steps

AutoAgents

Learn about automatically created and managed AI agents

Mini Agents

Explore lightweight, focused AI agents
For optimal results, ensure mathematical expressions and units are properly formatted for your specific use case.

Use a specialised agent that writes and runs code to solve problems.

Run lightweight, focused agents for single-purpose tasks.