SuperAgent 🥷

SuperAgent is a powerful tool that simplifies the configuration and deployment of LLM (Language Model) Agents to production. It provides a range of features and functionalities to make it easier for developers to work with LLMs and create conversational agents.

Roadmap

Here's an overview of the roadmap for SuperAgent:

• Bring your own DB: SuperAgent allows you to use your own database to store agent-related data.
• Authentication: Authentication mechanisms are implemented to secure the SuperAgent application.
• ChatGPT clone: SuperAgent includes a clone of ChatGPT, a powerful conversational AI model.
• Built-in memory: SuperAgent has a built-in memory to store context and information during conversations.
• REST API: SuperAgent provides a REST API to interact with the agents and perform various operations.
• Support for multiple LLMs: SuperAgent supports multiple Language Models, allowing you to choose the most suitable one for your needs.
• Streaming support: SuperAgent supports streaming conversations for real-time communication.
• Built-in vectorstore: SuperAgent includes a built-in vector store for efficient vector-based search and retrieval.
• Built-in document retrieval: SuperAgent offers document retrieval capabilities for finding relevant information.
• Q&A Agents: SuperAgent supports the creation of Q&A agents for answering specific questions.
• Tools: SuperAgent includes various tools to enhance agent development and management.
• ReAct Agents with Tools: SuperAgent enables the creation of reactive agents with the help of provided tools.
• Plan-solve Agents with Tools: SuperAgent supports the creation of plan-solve agents with the help of provided tools.
• Prompt management: SuperAgent includes features for managing and configuring prompts for the agents.
• Bring your own LLM: SuperAgent allows you to bring your own Language Model to use with the platform.
• Usage quotas and tracking: SuperAgent provides usage quotas and tracking mechanisms for better resource management.
• Python SDK: SuperAgent offers a Python Software Development Kit (SDK) for easier integration and development.
• Typescript SDK: SuperAgent provides a Typescript SDK for developers who prefer using Typescript.
• SuperAgent CLI: SuperAgent includes a command-line interface (CLI) for managing and deploying agents.
• One-click deploy (GCP, Amazon, DigitalOcean): SuperAgent aims to provide a one-click deploy feature for popular cloud platforms like GCP, Amazon, and DigitalOcean.

Stack

SuperAgent is built on the following technologies and frameworks:

• FastAPI: A modern, fast (high-performance) web framework for building APIs with Python.
• Supabase: An open-source alternative to Firebase that provides a suite of tools for building scalable applications.
• LangChain: A Python library for natural language processing and understanding.
• Prisma: A modern database toolkit that simplifies database access and management.
• Pinecone: A vector database that enables fast similarity search and retrieval.

Getting Started

To get started with SuperAgent, follow these steps:

1. Clone the SuperAgent repository into a public GitHub repository or fork it from https://github.com/homanp/superagent/fork. If you plan to distribute the code, keep the source code public.

   git clone https://github.com/homanp/superagent.git

2. Create and activate a virtual environment.

   virtualenv venv
   source venv/bin/activate

3. Install dependencies using Poetry.

   poetry install

4. Set up your .env file.

   cp .env.example .env

   • Configure the environment variables according to your requirements.

5. Run database migrations.

   poetry run prisma migrate dev

6. Run the SuperAgent project.

   uvicorn app.main:app --reload

Deployment

You can deploy SuperAgent using the "Deploy to DO" button, which will take you to the DigitalOcean App platform for easy deployment. Click on the button below to deploy:

Contributions

SuperAgent is an open-source project, and contributions are welcome. If you would like to contribute, you can create new features, fix bugs, or improve the infrastructure. Please refer to the CONTRIBUTING.md file in the repository for more information on how to contribute.

We appreciate your contributions and aim to make it easy for anyone to create and run LLM Agents in production using SuperAgent.