Skip to main content

The Ultimate Modular Autonomous Multi AI Agent Framework.

Project description


SuperAgentX: A lightweight autonomous true multi-agent framework with AGI capabilities.


Python 3.12+ GitHub Repo stars License: MIT

SuperAgentX - Multi-Agent, Browser Intelligence and MCP - Made Easy



Quick start

pip install superagentx

Install Playwright for Browser AI Automation

pip install playwright
playwright install

Browser AI Agent

import asyncio

from superagentx.agent import Agent
from superagentx.browser_engine import BrowserEngine
from superagentx.llm import LLMClient
from superagentx.prompt import PromptTemplate


async def main():
    llm_client: LLMClient = LLMClient(llm_config={'model': 'gpt-4.1', 'llm_type': 'openai'})

    prompt_template = PromptTemplate()

    browser_engine = BrowserEngine(
        llm=llm_client,
        prompt_template=prompt_template,

    )
    query_instruction = ("Which teams have won more than 3 FIFA World Cups, and which team is most likely to win the "
                         "next one?")

    fifo_analyser_agent = Agent(
        goal="Complete user's task.",
        role="You are a Football / Soccer Expert Reviewer",
        llm=llm_client,
        prompt_template=prompt_template,
        max_retry=1,
        engines=[browser_engine]
    )

    result = await fifo_analyser_agent.execute(
        query_instruction=query_instruction
    )

    print(result)


asyncio.run(main())

Run

$ export OPENAI_API_KEY=sk-******************

Key Features

🚀 Open-Source Framework: A lightweight, open-source AI framework built for multi-agent applications with Artificial General Intelligence (AGI) capabilities.

🎯 Goal-Oriented Multi-Agents: This technology enables the creation of agents with retry mechanisms to achieve set goals. Communication between agents is Parallel, Sequential, or hybrid.

🏖️ Easy Deployment: Offers WebSocket, RESTful API, and IO console interfaces for rapid setup of agent-based AI solutions.

♨️ Streamlined Architecture: Enterprise-ready scalable and pluggable architecture. No major dependencies; built independently!

📚 Contextual Memory: Uses SQL + Vector databases to store and retrieve user-specific context effectively.

🧠 Flexible LLM Configuration: Supports simple configuration options of various Gen AI models.

🤝 Extendable Handlers: Allows integration with diverse APIs, databases, data warehouses, data lakes, IoT streams, and more, making them accessible for function-calling features.

💎 Agentic RPA (Robotic Process Automation) – SuperAgentX enables computer-use automation for both browser-based and desktop applications, making it an ideal solution for enterprises looking to streamline operations, reduce manual effort, and boost productivity.

Table of contents

What is SuperAgentX?

The Ultimate Modular Autonomous Agentic AI Framework for Progressing Towards AGI.

SuperAgentX is an advanced agentic AI framework designed to accelerate the development of Artificial General Intelligence (AGI). It provides a powerful, modular, and flexible platform for building autonomous AI agents capable of executing complex tasks with minimal human intervention. By integrating cutting-edge AI technologies and promoting efficient, scalable agent behavior, SuperAgentX embodies a critical step forward in the path toward superintelligence and AGI. Whether for research, development, or deployment, SuperAgentX is built to push the boundaries of what's possible with autonomous AI systems.

Why SuperAgentX?

SuperAgentX addresses the growing need for highly capable, autonomous AI systems that can perform complex tasks with minimal human intervention. As we approach the limits of narrow AI, there's a need for an adaptable and scalable framework to bridge the gap toward AGI (Artificial General Intelligence). Here’s why SuperAgentX stands out:

Super: Cutting-edge AI systems with exceptional capabilities, paving the way to AGI (Artificial General Intelligence) and ASI (Artificial Super Intelligence).

Agent: Autonomous Multi AI agent framework designed to make decisions, act independently, and handle complex tasks.

X: The unknown, the limitless, the extra factor that makes SuperAgentX revolutionary, futuristic, and transformative.

Getting Started

pip install superagentx
Usage - Example SuperAgentX Code

This SuperAgentX example utilizes two handlers, Amazon and Walmart, to search for product items based on user input from the IO Console.

  1. It uses Parallel execution of handler in the agent
  2. Memory Context Enabled
  3. LLM configured to OpenAI
  4. Pre-requisites

Architecture

Large Language Models

Icon LLM Name                       Status
OpenAI
Azure OpenAI
AWS Bedrock
Google Gemini
Meta Llama
Ollama
Claude AI
Mistral AI
IBM WatsonX

Environment Setup

$ python3.12 -m pip install poetry
$ cd <path-to>/superagentx
$ python3.12 -m venv venv
$ source venv/bin/activate
(venv) $ poetry install

Documentation

License

SuperAgentX is released under the MIT License.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

superagentx-1.0.4b0.tar.gz (135.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

superagentx-1.0.4b0-py3-none-any.whl (173.8 kB view details)

Uploaded Python 3

File details

Details for the file superagentx-1.0.4b0.tar.gz.

File metadata

  • Download URL: superagentx-1.0.4b0.tar.gz
  • Upload date:
  • Size: 135.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.2.1 CPython/3.11.6 Darwin/24.6.0

File hashes

Hashes for superagentx-1.0.4b0.tar.gz
Algorithm Hash digest
SHA256 42e0e5b82cb09cc07a39d14b769bebdc685f88a6c6714cf58cbb6004da5e0b70
MD5 c0c7ddb8d980a87b73391f36052e379b
BLAKE2b-256 381d27d2a029afe47be63a775ca1dda52a6bc9311e826ae8dad50db73c66e44d

See more details on using hashes here.

File details

Details for the file superagentx-1.0.4b0-py3-none-any.whl.

File metadata

  • Download URL: superagentx-1.0.4b0-py3-none-any.whl
  • Upload date:
  • Size: 173.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.2.1 CPython/3.11.6 Darwin/24.6.0

File hashes

Hashes for superagentx-1.0.4b0-py3-none-any.whl
Algorithm Hash digest
SHA256 c440717f7bfe8f6f54e0b60e32de3e45bc6a9016908770aadbfbf06ac89898ba
MD5 6f4331c4dbb2d83c2d3ced398ffd799c
BLAKE2b-256 e29b758f0d97569eadd33f8a0da8098da62cd61891536d19af5f5598f26c0a49

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page