Python Version RequirementsMAOTO requires Python >=3.10. Here’s how to check your version:
python3 --version
If you need to update Python, visit python.org/downloads

​
Setting Up Your Environment

Before installing maoto-agent, it’s recommended to set up a virtual environment. This helps isolate your project dependencies and avoid conflicts.
1

Create a Virtual Environment

Choose your preferred method to create a virtual environment:Using venv (Python’s built-in tool):
Terminal
python3 -m venv .venv
Using conda:
Terminal
conda create -n maoto-env python=3.12
2

Activate the Virtual Environment

Activate your virtual environment based on your platform:On macOS/Linux (venv):
Terminal
source .venv/bin/activate
On Windows (venv):
Terminal
.venv\Scripts\activate
Using conda (all platforms):
Terminal
conda activate maoto-env

​
Installing MAOTO

1

Install `maoto-agent`

Install MAOTO Agent package:
Terminal
pip install maoto-agent
2

Upgrade `maoto-agent` (Existing Installations Only)

If you have an older version of maoto-agent installed, you can upgrade it:
Terminal
pip install --upgrade maoto-agent
Skip this step if you’re doing a fresh installation.
3

Verify Installation

Check your installed versions:
Terminal
pip freeze | grep maoto-agent
You should see something like:
Output
maoto-agent==X.X.X
Installation successful! You’re ready to create your first MAOTO Agent.

​
Next Steps

Build Your First AI System

Follow our quickstart guide to create your first MAOTO agent and get hands-on experience.

Explore MAOTO Concepts

Learn about MAOTO’s key roles and concepts to better understand how AI systems interact within the ecosystem.