diff --git a/.DS_Store b/.DS_Store
new file mode 100644
index 0000000..cd64d20
Binary files /dev/null and b/.DS_Store differ
diff --git a/tutorials/.DS_Store b/tutorials/.DS_Store
new file mode 100644
index 0000000..3c7d0d4
Binary files /dev/null and b/tutorials/.DS_Store differ
diff --git a/tutorials/aiXplain-agents/README.md b/tutorials/aiXplain-agents/README.md
new file mode 100644
index 0000000..06f3b41
--- /dev/null
+++ b/tutorials/aiXplain-agents/README.md
@@ -0,0 +1,107 @@
+
+
+ 
+
+
+
+# Travel Agent Powered by aiXplain
+
+## Overview
+
+This tutorial demonstrates the capabilities of the aiXplain platform in creating a modular multi-agent powered by Groq for fast inference speed. The Travel Agent combines advanced AI models, real-time data integration, and robust orchestration features to provide personalized and adaptive travel planning experiences.
+
+Built on aiXplain, this tutorial showcases how developers can easily design, build, and deploy intelligent agents without requiring extensive AI/ML expertise.
+
+## Why aiXplain?
+
+aiXplain is a comprehensive platform designed for building, optimizing, and deploying multi-agent systems with ease. Key highlights include:
+
+- **Wide Range of Models**: Access over 100 Large Language Models (LLMs) and 38,000+ AI tools from leading providers like Groq, OpenAI, and Google.
+- **Single Access Key**: Simplify model integration with a single-key system and enjoy the best pricing across platforms.
+- **Modular AI Agents**: Build standalone or multi-agent systems that are customizable and ready for real-world tasks.
+- **Integrated Tooling**: Fine-tune models, benchmark performance, and integrate advanced debugging features effortlessly.
+- **Enterprise-Ready**: Provides robust security, scalability, and compliance for professional deployments.
+
+## Features Demonstrated in This Project
+### 1. Agent Design and Orchestration
+- **Scraper Utility Agent**: Gathers insights from travel blogs and review platforms.
+- **Location Agent**: Offers personalized recommendations for nearby landmarks and activities.
+- **Weather Agent**: Provides real-time weather updates and forecasts.
+
+### 2. Team Agents
+- Combines individual agents into a cohesive system, enabling them to work collaboratively for complex workflows.
+
+### 3. Effortless Deployment
+- Publish agents as APIs with a single click using aiXplain's streamlined interface.
+- Integrate APIs into applications via OpenAI standards, Python, Swift, or cURL.
+
+
+## How to Use aiXplain for Your Projects
+
+### Install the aiXplain SDK
+
+```python
+pip install aixplain
+```
+
+### Obtain Your Access Key
+Register on aiXplain and retrieve your access key from the [Integrations](https://platform.aixplain.com/account/integrations) page.
+
+```python
+import os
+os.environ["AIXPLAIN_API_KEY"] = ""
+```
+
+### Build Your Agent
+Leverage the power of **Groq-enhanced LLMs** by utilizing `AgentFactory` to design highly efficient agents.
+
+When creating an agent, you can optionally specify an `llm_id` to integrate a specific Large Language Model (LLM) for enhanced performance. To find an llm_id, browse available models on the [**aiXplain Marketplace**](https://platform.aixplain.com/discover?page=1&owner=6839), and copy the ID from the model details.
+
+```python
+from aixplain.factories import AgentFactory
+
+scraper_agent = AgentFactory.create(
+ name="Scraper Utility Agent",
+ description="Gathers travel insights based on user preferences.",
+ tools=[...],
+ llm_id="..."
+)
+```
+
+### Combine Agents into a Team
+Create a multi-agent system for complex workflows:
+
+```python
+from aixplain.factories import TeamAgentFactory
+
+team_agent = TeamAgentFactory.create(
+ name="Travel Agent",
+ description="A comprehensive travel planning system.",
+ agents=[scraper_agent, location_agent, weather_agent]
+)
+```
+
+### Run and Deploy
+Test and deploy your agents to generate APIs for integration:
+
+```python
+result = team_agent.run("Plan a day trip to Boston")
+print(result)
+```
+Deploy your agent when you are ready:
+
+```python
+team_agent.deploy()
+```
+
+## See it in action
+
+
+
+
+## Learn More
+Explore aiXplain's capabilities: [aiXplain Platform](https://aixplain.com/)
+Access tutorials and guides: [aiXplain Documentation](https://www.google.com/url?q=https%3A%2F%2Fdocs.aixplain.com)
+Join the community: [aiXplain Discord](https://www.google.com/url?q=https%3A%2F%2Fhttps%3A%2F%2Fdiscord.com%2Finvite%2FT5dCmjRSYA)
+
+Start building intelligent systems with aiXplain today and transform how you deploy AI solutions! ๐๐ค
\ No newline at end of file
diff --git a/tutorials/aiXplain-agents/aiXplain_Agents.ipynb b/tutorials/aiXplain-agents/aiXplain_Agents.ipynb
new file mode 100644
index 0000000..2a8066a
--- /dev/null
+++ b/tutorials/aiXplain-agents/aiXplain_Agents.ipynb
@@ -0,0 +1,386 @@
+{
+ "cells": [
+ {
+ "cell_type": "markdown",
+ "metadata": {
+ "id": "6DVrtzTcvBtn"
+ },
+ "source": [
+ "\n",
+ "\n",
+ "\n",
+ "\n",
+ "\n",
+ "---"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "### **An AI platform for building, optimizing and deploying multi-agent systems without AI/ML expertise.**\n",
+ "\n",
+ "\n",
+ "### **Core features**\n",
+ "- ๐ค **Multi-agent orchestration** features a modular design with built-in **planning**, **I/O validation**, and **memory** for context-aware conversations\n",
+ "- ๐ **Access advanced models** with over 100 LLMs from OpenAI, Meta, AWS, Anthropic, Google, Groq and others, alongside 38,000+ AI models and utilities. Enjoy the best prices and single-key access.\n",
+ "- ๐ Swap and use **any LLM** in your agent, optimized for GPT-4o and Llama 3.1 70B.\n",
+ "- ๐ **Tooling** available for fine-tuning LLMs and benchmarking them effectively.\n",
+ "- ๐ **Publish as an API** with a single click, and integrate into any application using OpenAI API standards, cURL, Python, and Swift support.\n",
+ "- ๐ **Built-in observability** with detailed logs and statistics for every agent interaction.\n",
+ "- ๐ฌ **A no-code** conversational interface for creating agentic workflows ([try it!](https://belesprit.aixplain.com/)).\n",
+ "- ๐ข **Enterprise-ready** features ensure robust security, scalability, and compliance."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "### **A step-by-step guide to build, run and deploy multi-agents powered by Groq**\n",
+ "AI agents ๐ค are software that uses reasoning models, like **language models** (LLM/SLM), and **tools** like APIs or custom code, along with data sources, to reason, plan, reflect, and execute tasks **autonomously**.\n",
+ "\n",
+ "For a single task, create an **agent**. For a complex task, build a **team agent**.\n",
+ "\n",
+ "๐ Agents are ideal if the AI solution should autonomously plan how a task should be executed. If you already know how a task should be executed, consider using [agentic pipelines](https://docs.aixplain.com/guides/how-to-build-a-pipeline).\n",
+ "\n",
+ "### Before you start\n",
+ "๐ **To run this colab you need an aiXplain access key from [here](https://platform.aixplain.com/account/integrations).**\n",
+ "\n",
+ "๐ฐ **Get free credits upon registrationโenough for over 3,000 API calls! Then only pay for what you use.**\n",
+ "\n",
+ "โ ๏ธ **Save a version of this colab in your own Drive to be able to edit it.**\n",
+ "\n",
+ "๐ **For more tutorials and documentation, visit our [docs](https://docs.aixplain.com).**\n",
+ "\n",
+ "๐ฅ **Join us on [Discord](https://https://discord.com/invite/T5dCmjRSYA) to get support and connect with our community!**\n"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {
+ "id": "i5By-cHV0h8E"
+ },
+ "source": [
+ "# **Getting Started with aiXplain**\n",
+ "\n",
+ "**Install the aiXplain SDK to get started!**"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "metadata": {
+ "colab": {
+ "base_uri": "https://localhost:8080/"
+ },
+ "id": "FhrokNUYSnfW",
+ "outputId": "57facfb9-7be0-4d32-d9fb-c9e447dd28f7"
+ },
+ "outputs": [],
+ "source": [
+ "!pip install aixplain"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "**Add your aiXplain access key**\n",
+ "\n",
+ "If you haven't yet, register to receive **5 credits** and get your aiXplain **access key** from the [Integrations](https://platform.aixplain.com/account/integrations) page."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "metadata": {
+ "cellView": "form",
+ "id": "RTwYeYvE0ock"
+ },
+ "outputs": [],
+ "source": [
+ "import os\n",
+ "os.environ[\"AIXPLAIN_API_KEY\"] = \"\""
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {
+ "id": "hzv5_trn1f1V"
+ },
+ "source": [
+ "# Build Your Agents\n",
+ "\n",
+ "To create an agent, define:\n",
+ "\n",
+ "* A unique **name** and **description** for its purpose.\n",
+ "* The **tools** *(optional)* it will use, such as specific AI models or pipelines.\n",
+ "* The **language model** *(optional)* to enhance its performance. By default, aiXplain agents use OpenAI's GPT-4o. This tutorial uses [Llama 3.1 8B](https://platform.aixplain.com/discover/model/66b270bb6eb56365551e8c71) powered by Groq as the LLM for the agents for fast inference speed. You can optionally specify an `llm_id` to integrate a specific Large Language Model (LLM) for enhanced performance. To find an llm_id, browse available models on [Discover](https://platform.aixplain.com/discover?page=1&owner=6839), and copy the ID from the model details.\n",
+ "\n",
+ "\n",
+ "Discover cutting-edge models powered by **Groq** on our [aiXplain Marketplace](https://platform.aixplain.com/discover?page=1&owner=6839). Easily integrate these high-performance assets into your agents by using their unique IDs as tools.\n",
+ "\n",
+ "Cannot find what you want? Send us a request on [Discord](https://www.google.com/url?q=https%3A%2F%2Fdiscord.com%2Finvite%2FT5dCmjRSYA) and we will make it available for you.\n",
+ "\n",
+ "\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "metadata": {
+ "id": "cvqaAfHBTipx"
+ },
+ "outputs": [],
+ "source": [
+ "from aixplain.modules.agent import ModelTool\n",
+ "from aixplain.factories import AgentFactory\n",
+ "from aixplain.factories import TeamAgentFactory"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {
+ "id": "8bn4RQi17MUP"
+ },
+ "source": [
+ "### Scraper Agent\n",
+ "\n",
+ "The Scraper Utility Agent is a specialized AI agent designed to streamline the process of gathering and summarizing insights from travel blogs, review websites, and event listing platforms. It identifies key recommendations about activities, restaurants, and must-see locations based on user preferences, such as budget constraints or specific interests like food and outdoor activities.\n",
+ "It uses the Scraper Utility linked [here](https://platform.aixplain.com/discover/model/66f423426eb563fa213a3531)."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "metadata": {
+ "id": "C5T_hGgoTisk"
+ },
+ "outputs": [],
+ "source": [
+ "scraper_agent = AgentFactory.create(\n",
+ " name= \"Scraper Utility Agent\",\n",
+ " description=\"Scrapes travel blogs, review websites, or event listing platforms to gather insights about activities, restaurants, or must-see locations. Summarize and rank recommendations based on user preferences (e.g., budget, interests like food, outdoor activities, etc.).\",\n",
+ " tools=[ModelTool(model=\"66f423426eb563fa213a3531\")],\n",
+ " llm_id=\"66b270bb6eb56365551e8c71\"\n",
+ ")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {
+ "id": "qDdTdX218t_1"
+ },
+ "source": [
+ "### Location Agent\n",
+ "\n",
+ "The Location Agent is an AI-driven assistant designed to provide personalized recommendations for nearby places of interest. By leveraging user-provided location data, it identifies landmarks, restaurants, and activity hubs tailored to the user's context and preferences powered by the [Places API by Google](https://platform.aixplain.com/discover?page=1&function=utilities&inputDataType=text&outputDataType=text)."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "metadata": {
+ "id": "8qZBEMZAZqnY"
+ },
+ "outputs": [],
+ "source": [
+ "location_agent = AgentFactory.create(\n",
+ " name=\"Location Agent\",\n",
+ " description=\" Fetches nearby places of interest such as landmarks, restaurants, or activity hubs based on user-provided locations. Integrates real-time user input, like whether theyโre traveling with family or solo, to filter results\",\n",
+ " tools=[ModelTool(model=\"66f6ac496eb563510e3503d1\")],\n",
+ " llm_id=\"66b270bb6eb56365551e8c71\"\n",
+ ")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {
+ "id": "hepA3OTB9JMs"
+ },
+ "source": [
+ "### Weather Agent\n",
+ "The Weather Agent is an AI-powered assistant that delivers up-to-date weather information and forecasts tailored to the userโs specified destination using the [Open Weather API](https://platform.aixplain.com/discover/model/66f83c216eb563266175e201). Use the `description` parameter to update the description of models and tools. \n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "metadata": {
+ "id": "Oi5zIQV1aFk0"
+ },
+ "outputs": [],
+ "source": [
+ "weather_agent = AgentFactory.create(\n",
+ " name=\"Weather Agent\",\n",
+ " description=\" Provides real-time weather updates and forecasts for the user's destination.\",\n",
+ " tools=[ModelTool(model=\"66f83c216eb563266175e201\", description=\"The input query of this tool must be of the form 'text': 'City'.\")],\n",
+ " llm_id=\"66b270bb6eb56365551e8c71\"\n",
+ ")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {
+ "id": "H1wbohXcMz0E"
+ },
+ "source": [
+ "# Team Agents\n",
+ "\n",
+ "Team Agents are advanced systems that combine multiple agents into a cohesive, collaborative unit. These team agents are designed to tackle complex workflows that require multiple specialized agents working together.\n",
+ "\n",
+ "To create a Team Agent:\n",
+ "\n",
+ "* Define a **name** and **description** for the team agent.\n",
+ "* List the **agents** to include in the team.\n",
+ "* Specify a **llm_id** (optional) for powering the teamโs interactions.\n",
+ "* Set **use_mentalist_and_inspector** (optional) to specify whether to include advanced debugging and optimization tools like Mentalist and Inspector. This is set to `True` by default for enhanced performance and troubleshooting capabilities."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {
+ "id": "eph4DgijOGFm"
+ },
+ "source": [
+ "The Travel Agent is an AI-driven multi-agent system designed to streamline trip planning by integrating real-time updates and personalized recommendations. It combines the capabilities of individual agents to provide tailored suggestions for activities, restaurants, and landmarks, based on user preferences and location. Additionally, it offers real-time weather forecasts and alternative plans for unfavorable conditions, ensuring a smooth and adaptable travel experience."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "metadata": {
+ "id": "7TjYoTskaecn"
+ },
+ "outputs": [],
+ "source": [
+ "team = TeamAgentFactory.create(\n",
+ " name=\"Travel Agent\",\n",
+ " description=\"\"\"An agent designed to help users plan trips and get real-time updates on the best activities, local weather, and nearby points of interest.\n",
+ " Integrates real-time user input, like whether theyโre traveling with family or solo, to filter results.\n",
+ " Fetches nearby places of interest such as landmarks, restaurants, or activity hubs based on user-provided locations.\n",
+ " Suggests alternate plans or indoor activities in case of unfavorable weather conditions.\n",
+ " \"\"\",\n",
+ " agents=[scraper_agent, location_agent, weather_agent]\n",
+ ")"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {
+ "id": "bVqbs0kaPJXk"
+ },
+ "source": [
+ "# Run your Agent\n",
+ "\n",
+ "To ensure your agents are performing as expected, run them using the run method with sample inputs. Analyze the outputs, verify their accuracy, and debug any issues by inspecting the agent's configurations, tools, and logic. Adjust parameters like tool descriptions, LLM models, or input formatting as needed."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "metadata": {
+ "id": "EPFyka48du9_"
+ },
+ "outputs": [],
+ "source": [
+ "result = team.run(\"Plan a day trip to Boston this Saturday for a family of four.โ\")"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "metadata": {
+ "colab": {
+ "base_uri": "https://localhost:8080/"
+ },
+ "id": "SaaiWia6fSSB",
+ "outputId": "d1e8c256-f288-4641-f37e-d6eb21a8b03c"
+ },
+ "outputs": [],
+ "source": [
+ "print(result['data']['output'])"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "metadata": {
+ "colab": {
+ "base_uri": "https://localhost:8080/"
+ },
+ "id": "-F8QfDEJfnXQ",
+ "outputId": "2269d00d-2d40-4547-c5e7-8b095f6f3a87"
+ },
+ "outputs": [],
+ "source": [
+ "result = team.run(\"Plan a four day trip to London and Edinburgh for the first week of January.โ\")\n",
+ "print(result)"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "metadata": {
+ "colab": {
+ "base_uri": "https://localhost:8080/"
+ },
+ "id": "KGrAObK3my_R",
+ "outputId": "46220841-c6dc-4d8c-bb82-bedf224149ae"
+ },
+ "outputs": [],
+ "source": [
+ "print(result['data']['output'])"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {
+ "id": "HAAg7D3nVgGY"
+ },
+ "source": [
+ "# Deploy your Agent\n",
+ "\n",
+ "Agents are saved as drafts initially. Keep them in draft mode while debugging to ensure all issues are resolved. Deploy your team agent to receive an API. This will also auto-deploy the agents in the team. The team agent and member agents will be available in your dashboard https://platform.aixplain.com/dashboard"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "metadata": {
+ "id": "4_pUwmxmR-fA"
+ },
+ "outputs": [],
+ "source": [
+ "team.deploy()"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {
+ "id": "h27mCKNMWWeY"
+ },
+ "source": [
+ "aiXplain empowers you to seamlessly build, customize, and deploy intelligent agents tailored to your specific needs. Whether you're creating standalone agents or advanced multi-agent systems, the platform provides a robust toolkit for integrating cutting-edge AI capabilities into your workflows. To further enhance your applications or explore more features, such as integrating additional tools, leveraging multi-modal pipelines, or scaling with team agents, visit https://aixplain.com/. \n",
+ "\n",
+ "Start leveraging the full potential of aiXplain to transform how you design and deploy AI solutions ๐๐ค\n",
+ "\n"
+ ]
+ }
+ ],
+ "metadata": {
+ "colab": {
+ "provenance": []
+ },
+ "kernelspec": {
+ "display_name": "Python 3",
+ "name": "python3"
+ },
+ "language_info": {
+ "name": "python",
+ "version": "3.12.4"
+ }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 0
+}
diff --git a/tutorials/aiXplain-agents/images/Aixplain Logo.png b/tutorials/aiXplain-agents/images/Aixplain Logo.png
new file mode 100644
index 0000000..e1cacdc
Binary files /dev/null and b/tutorials/aiXplain-agents/images/Aixplain Logo.png differ