SuperAGI

repository·main·Indexed 12 days ago

https://github.com/transformeroptimus/superagi

A developer-first, open-source autonomous AI agent framework designed to build, manage, and run scalable agents. SuperAGI features a GUI, an Action Console, and a marketplace of toolkits for integrations including GitHub, Google Calendar, DuckDuckGo, and Email. It supports agent memory storage, vector DB connections, and custom fine-tuned models to perform complex tasks using ReAct LLM workflows.

Tokens
7.9K
Snippets
13
Records
55
Agent score
96%

What's inside SuperAGI

  1. SuperAGI Core Features Overview

    main

    SuperAGI is an autonomous AI agent framework with the following core capabilities:

    • Agent Management: Provision, spawn, and deploy scalable autonomous agents.
    • Toolkits: Extend agent capabilities via a marketplace of third-party plugins.
    • User Interface: Manage agents through a Graphical User Interface (GUI) and an Action Console for real-time interaction and permission granting.
    • Memory & Learning: Use Agent Memory Storage to enable agents to learn and adapt over time.
    • Data & Models: Connect to multiple Vector DBs and use custom fine-tuned models for specific business use cases.
    • Optimization: Monitor performance via telemetry and manage costs through optimized token usage control.
    • Workflows: Automate tasks using predefined ReAct LLM steps.
  2. Extend SuperAGI with Toolkits

    main

    Toolkits allow SuperAGI agents to interact with external systems and third-party plugins. You can add capabilities to your agent workflows using toolkits available in the marketplace.

    Supported integrations include (but are not limited to):

    • Search & Web: Google Search, DuckDuckGo, Serp API, Searx, Web Scraper, Web Interaction.
    • Communication & Social: Twitter, Instagram, Email, Gmail.
    • Productivity & Management: Jira, Notion, Google Calendar, File Manager.
    • Development: GitHub, Coding Tools.
    • Media & Knowledge: Dall-E, Knowledge Search.
  3. Configure Jira settings in the SuperAGI Dashboard

    main

    To use the Jira tool, you must provide authentication and instance details in the SuperAGI Dashboard's Jira Toolkit Page.

    Required configuration settings:

    1. JIRA API TOKEN: Generated from your Jira account under 'Manage Account' > 'Security' > 'Create and Manage API Tokens'.
    2. JIRA INSTANCE URL: The base URL of your Jira instance (e.g., https://mycompany.atlassian.net/).
    3. JIRA USERNAME: The email address used to sign up for Jira.

    After entering these values in the Jira Toolkit Page, click Update Changes to apply the configuration.

  4. Use the SuperAGI GitHub Tool for repository operations

    main

    You interact with the GitHub Tool by specifying requirements within your goal. The tool operates on the main branch by default unless a specific branch is mentioned.

    Supported Operations

    Add Files or Folders

    To add content, include the following in your goal:

    • The target repository name.
    • The owner's UserName.
    • The path where the file/folder should be added. Note: SuperAGI will upload the content and automatically raise a Pull Request (PR).

    Delete Files

    To remove content, include the following in your goal:

    • The target repository name.
    • The owner's UserName.
    • The path to the file you want to delete. Note: SuperAGI will handle the deletion and automatically raise a Pull Request (PR).

    Search for Files or Folders

    To find content, include the following in your goal:

    • The target repository name.
    • The owner's UserName.
    • The name or path of the file/folder you are looking for.

    Branch Specification

    If you need to perform any of these operations on a branch other than main, you must explicitly mention the desired branch name in your goal.

  5. Set up the Google Calendar API and OAuth Consent Screen

    main

    Before configuring the toolkit in SuperAGI, you must enable the Google Calendar API and set up an OAuth consent screen in the Google Cloud Console:

    1. Create/Select a Project: Go to the Google Developer Console and create a new project.
    2. Enable API: Navigate to "APIs and Services" > "ENABLED APIS AND SERVICES", search for "Google Calendar", and enable it.
    3. Configure OAuth Consent Screen:
      • Go to "OAuth Consent Screen".
      • Select User Type as "External" and click "Create".
      • Fill in required App Information (App Name, App Domain, Authorized Domain, and Developer contact info).
      • Click "Save and Continue" through the scopes and summary pages.
      • Return to the dashboard and click "Publish App" to make it active.
  6. Install and use the SuperAGI Searx Search Tool

    main

    The SuperAGI Searx Search Tool allows agents to perform searches via Searx instances and extract snippets and webpage content. Because many Searx instances require an API key for JSON responses, this tool is designed to parse HTML response pages directly to extract information.

    Installation

    1. Set up SuperAGI core: Before using the tool, you must first install and configure the main SuperAGI framework by following the primary installation guide: https://github.com/TransformerOptimus/SuperAGI/blob/main/README.MD
    2. Tool Availability: Once SuperAGI is running, the Searx tool is available for your agents to use for internet browsing tasks.
  7. Configure Twitter OAuth Settings

    main

    For SuperAGI to interact with Twitter, you must configure User Authentication settings in the Twitter Developer Portal:

    1. Navigate to App Settings in your Twitter App.
    2. Locate User Authentication Settings and click to set them up.
    3. Set the App Type to Web Application.
    4. Set Permissions to Read and Write Permissions.
    5. Provide the required Callback URI and Website URL as specified in the SuperAGI integration requirements.
    6. Save the settings.