Skip to content

A simple to use package to call various model providers such as openai, anthropic, and others with utmost reliability, security, and performance.

License

Notifications You must be signed in to change notification settings

The-Swarm-Corporation/swarm-models

Repository files navigation

Swarm Models

Join our Discord Subscribe on YouTube Connect on LinkedIn Follow on X.com

Swarm Models provides a unified, secure, and highly scalable interface for interacting with multiple LLM and multi-modal APIs across different providers. It is built to streamline your API integrations, ensuring production-grade reliability and robust performance.

Key Features:

  • Multi-Provider Support: Integrate seamlessly with APIs from OpenAI, Anthropic, Azure, and more.

  • Enterprise-Grade Security: Built-in security protocols to protect your API keys and sensitive data, ensuring compliance with industry standards.

  • Lightning-Fast Performance: Optimized for low-latency and high-throughput, Swarm Models delivers blazing-fast API responses, suitable for real-time applications.

  • Ease of Use: Simplified API interaction with intuitive .run(task) and __call__ methods, making integration effortless.

  • Scalability for All Use Cases: Whether it's a small script or a massive enterprise-scale application, Swarm Models scales effortlessly.

  • Production-Grade Reliability: Tested and proven in enterprise environments, ensuring consistent uptime and failover capabilities.


Onboarding

Swarm Models simplifies the way you interact with different APIs by providing a unified interface for all models.

1. Install Swarm Models

$ pip3 install -U swarm-models

2. Set Your Keys

OPENAI_API_KEY="your_openai_api_key"
GROQ_API_KEY="your_groq_api_key"
ANTHROPIC_API_KEY="your_anthropic_api_key"
AZURE_OPENAI_API_KEY="your_azure_openai_api_key"

3. Initialize a Model

Import the desired model from the package and initialize it with your API key or necessary configuration.

from swarm_models import YourDesiredModel

model = YourDesiredModel(api_key='your_api_key', *args, **kwargs)

4. Run Your Task

Use the .run(task) method or simply call the model like model(task) with your task.

task = "Define your task here"
result = model.run(task)

# Or equivalently
#result = model(task)

5. Enjoy the Results

print(result)

Full Code Example

from swarm_models import OpenAIChat
import os

# Get the OpenAI API key from the environment variable
api_key = os.getenv("OPENAI_API_KEY")

# Create an instance of the OpenAIChat class
model = OpenAIChat(openai_api_key=api_key, model_name="gpt-4o-mini")

# Query the model with a question
out = model(
   "What is the best state to register a business in the US for the least amount of taxes?"
)

# Print the model's response
print(out)

TogetherLLM Documentation

The TogetherLLM class is designed to simplify the interaction with Together's LLM models. It provides a straightforward way to run tasks on these models, including support for concurrent and batch processing.

Initialization

To use TogetherLLM, you need to initialize it with your API key, the name of the model you want to use, and optionally, a system prompt. The system prompt is used to provide context to the model for the tasks you will run.

Here's an example of how to initialize TogetherLLM:

import os
from swarm_models import TogetherLLM

model_runner = TogetherLLM(
    api_key=os.environ.get("TOGETHER_API_KEY"),
    model_name="meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo",
    system_prompt="You're Larry fink",
)

Running Tasks

Once initialized, you can run tasks on the model using the run method. This method takes a task string as an argument and returns the response from the model.

Here's an example of running a single task:

task = "How do we allocate capital efficiently in your opinion Larry?"
response = model_runner.run(task)
print(response)

Running Multiple Tasks Concurrently

TogetherLLM also supports running multiple tasks concurrently using the run_concurrently method. This method takes a list of task strings and returns a list of responses from the model.

Here's an example of running multiple tasks concurrently:

tasks = [
    "What are the top-performing mutual funds in the last quarter?",
    "How do I evaluate the risk of a mutual fund?",
    "What are the fees associated with investing in a mutual fund?",
    "Can you recommend a mutual fund for a beginner investor?",
    "How do I diversify my portfolio with mutual funds?",
]
responses = model_runner.run_concurrently(tasks)
for response in responses:
    print(response)

Enterprise-Grade Features

  1. Security: API keys and user data are handled with utmost care, utilizing encryption and best security practices to protect your sensitive information.

  2. Production Reliability: Swarm Models has undergone rigorous testing to ensure that it can handle high traffic and remains resilient in enterprise-grade environments.

  3. Fail-Safe Mechanisms: Built-in failover handling to ensure uninterrupted service even under heavy load or network issues.

  4. Unified API: No more dealing with multiple SDKs or libraries. Swarm Models standardizes your interactions across providers like OpenAI, Anthropic, Azure, and more, so you can focus on what matters.


Available Models

Model Name Description
OpenAIChat Chat model for OpenAI's GPT-3 and GPT-4 APIs.
Anthropic Model for interacting with Anthropic's APIs.
AzureOpenAI Azure's implementation of OpenAI's models.
Dalle3 Model for generating images from text prompts.
NvidiaLlama31B Llama model for causal language generation.
Fuyu Multi-modal model for image and text processing.
Gemini Multi-modal model for vision and language tasks.
Vilt Vision-and-Language Transformer for question answering.
TogetherLLM Model for collaborative language tasks.
FireWorksAI Model for generating creative content.
ReplicateChat Chat model for replicating conversations.
HuggingfaceLLM Interface for Hugging Face models.
CogVLMMultiModal Multi-modal model for vision and language tasks.
LayoutLMDocumentQA Model for document question answering.
GPT4VisionAPI Model for analyzing images with GPT-4 capabilities.
LlamaForCausalLM Causal language model from the Llama family.
GroundedSAMTwo Analyzes and track objects in images. GPU Only

Support & Contributions

  • Documentation: Comprehensive guides, API references, and best practices are available in our official Documentation.
  • GitHub: Explore the code, report issues, and contribute to the project via our GitHub repository.

License

Swarm Models is released under the MIT License.


About

A simple to use package to call various model providers such as openai, anthropic, and others with utmost reliability, security, and performance.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published