You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
216 lines
8.1 KiB
216 lines
8.1 KiB
|
|
|
|
<div align="center">
|
|
|
|
Swarms is a modular framework that enables reliable and useful multi-agent collaboration at scale to automate real-world tasks.
|
|
|
|
|
|
[](https://github.com/kyegomez/swarms/issues) [](https://github.com/kyegomez/swarms/network) [](https://github.com/kyegomez/swarms/stargazers) [](https://github.com/kyegomez/swarms/blob/main/LICENSE)[](https://star-history.com/#kyegomez/swarms)[](https://libraries.io/github/kyegomez/swarms) [](https://pepy.tech/project/swarms)
|
|
|
|
|
|
### Share on Social Media
|
|
|
|
[](https://twitter.com/intent/tweet?text=Check%20out%20this%20amazing%20AI%20project:%20&url=https%3A%2F%2Fgithub.com%2Fkyegomez%2Fswarms) [](https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Fgithub.com%2Fkyegomez%2Fswarms) [](https://www.linkedin.com/shareArticle?mini=true&url=https%3A%2F%2Fgithub.com%2Fkyegomez%2Fswarms&title=&summary=&source=)
|
|
|
|
[](https://www.reddit.com/submit?url=https%3A%2F%2Fgithub.com%2Fkyegomez%2Fswarms&title=Swarms%20-%20the%20future%20of%20AI) [](https://news.ycombinator.com/submitlink?u=https%3A%2F%2Fgithub.com%2Fkyegomez%2Fswarms&t=Swarms%20-%20the%20future%20of%20AI) [](https://pinterest.com/pin/create/button/?url=https%3A%2F%2Fgithub.com%2Fkyegomez%2Fswarms&media=https%3A%2F%2Fexample.com%2Fimage.jpg&description=Swarms%20-%20the%20future%20of%20AI) [](https://api.whatsapp.com/send?text=Check%20out%20Swarms%20-%20the%20future%20of%20AI%20%23swarms%20%23AI%0A%0Ahttps%3A%2F%2Fgithub.com%2Fkyegomez%2Fswarms)
|
|
|
|
</div>
|
|
|
|
[](https://github.com/users/kyegomez/projects/1)
|
|
|
|
## Vision
|
|
At Swarms, we're transforming the landscape of AI from siloed AI agents to a unified 'swarm' of intelligence. Through relentless iteration and the power of collective insight from our 1500+ Agora researchers, we're developing a groundbreaking framework for AI collaboration. Our mission is to catalyze a paradigm shift, advancing Humanity with the power of unified autonomous AI agent swarms.
|
|
|
|
-----
|
|
|
|
## 🤝 Schedule a 1-on-1 Session
|
|
|
|
Book a [1-on-1 Session with Kye](https://calendly.com/swarm-corp/30min), the Creator, to discuss any issues, provide feedback, or explore how we can improve Swarms for you.
|
|
|
|
|
|
----------
|
|
|
|
## Installation
|
|
`pip3 install --upgrade swarms`
|
|
|
|
---
|
|
|
|
## Usage
|
|
We have a small gallery of examples to run here, [for more check out the docs to build your own agent and or swarms!](https://docs.apac.ai)
|
|
|
|
### `MultiAgentDebate`
|
|
|
|
- `MultiAgentDebate` is a simple class that enables multi agent collaboration.
|
|
|
|
```python
|
|
from swarms.workers import Worker
|
|
from swarms.swarms import MultiAgentDebate, select_speaker
|
|
from swarms.models import OpenAIChat
|
|
|
|
|
|
api_key = "sk-"
|
|
|
|
llm = OpenAIChat(
|
|
model_name='gpt-4',
|
|
openai_api_key=api_key,
|
|
temperature=0.5
|
|
)
|
|
|
|
node = Worker(
|
|
llm=llm,
|
|
openai_api_key=api_key,
|
|
ai_name="Optimus Prime",
|
|
ai_role="Worker in a swarm",
|
|
external_tools = None,
|
|
human_in_the_loop = False,
|
|
temperature = 0.5,
|
|
)
|
|
|
|
node2 = Worker(
|
|
llm=llm,
|
|
openai_api_key=api_key,
|
|
ai_name="Bumble Bee",
|
|
ai_role="Worker in a swarm",
|
|
external_tools = None,
|
|
human_in_the_loop = False,
|
|
temperature = 0.5,
|
|
)
|
|
|
|
node3 = Worker(
|
|
llm=llm,
|
|
openai_api_key=api_key,
|
|
ai_name="Bumble Bee",
|
|
ai_role="Worker in a swarm",
|
|
external_tools = None,
|
|
human_in_the_loop = False,
|
|
temperature = 0.5,
|
|
)
|
|
|
|
agents = [
|
|
node,
|
|
node2,
|
|
node3
|
|
]
|
|
|
|
# Initialize multi-agent debate with the selection function
|
|
debate = MultiAgentDebate(agents, select_speaker)
|
|
|
|
# Run task
|
|
task = "What were the winning boston marathon times for the past 5 years (ending in 2022)? Generate a table of the year, name, country of origin, and times."
|
|
results = debate.run(task, max_iters=4)
|
|
|
|
# Print results
|
|
for result in results:
|
|
print(f"Agent {result['agent']} responded: {result['response']}")
|
|
```
|
|
|
|
----
|
|
|
|
### `Worker`
|
|
- The `Worker` is an fully feature complete agent with an llm, tools, and a vectorstore for long term memory!
|
|
- Place your api key as parameters in the llm if you choose!
|
|
- And, then place the openai api key in the Worker for the openai embedding model
|
|
|
|
```python
|
|
from swarms.models import OpenAIChat
|
|
from swarms import Worker
|
|
|
|
api_key = ""
|
|
|
|
llm = OpenAIChat(
|
|
openai_api_key=api_key,
|
|
temperature=0.5,
|
|
)
|
|
|
|
node = Worker(
|
|
llm=llm,
|
|
ai_name="Optimus Prime",
|
|
openai_api_key=api_key,
|
|
ai_role="Worker in a swarm",
|
|
external_tools=None,
|
|
human_in_the_loop=False,
|
|
temperature=0.5,
|
|
)
|
|
|
|
task = "What were the winning boston marathon times for the past 5 years (ending in 2022)? Generate a table of the year, name, country of origin, and times."
|
|
response = node.run(task)
|
|
print(response)
|
|
|
|
|
|
```
|
|
|
|
------
|
|
|
|
### `OmniModalAgent`
|
|
- OmniModal Agent is an LLM that access to 10+ multi-modal encoders and diffusers! It can generate images, videos, speech, music and so much more, get started with:
|
|
|
|
```python
|
|
from swarms.models import OpenAIChat
|
|
from swarms.agents import OmniModalAgent
|
|
|
|
api_key = "SK-"
|
|
|
|
llm = OpenAIChat(model_name="gpt-4", openai_api_key=api_key)
|
|
|
|
agent = OmniModalAgent(llm)
|
|
|
|
agent.run("Create a video of a swarm of fish")
|
|
|
|
```
|
|
|
|
|
|
### `Flow` Example
|
|
- The `Flow` is a superior iteratioin of the `LLMChain` from Langchain, our intent with `Flow` is to create the most reliable loop structure that gives the agents their "autonomy" through 3 main methods of interaction, one through user specified loops, then dynamic where the agent parses a <DONE> token, and or an interactive human input verison, or a mix of all 3.
|
|
```python
|
|
|
|
from swarms.models import OpenAIChat
|
|
from swarms.structs import Flow
|
|
|
|
api_key = ""
|
|
|
|
|
|
# Initialize the language model,
|
|
# This model can be swapped out with Anthropic, ETC, Huggingface Models like Mistral, ETC
|
|
llm = OpenAIChat(
|
|
openai_api_key=api_key,
|
|
temperature=0.5,
|
|
)
|
|
|
|
# Initialize the flow
|
|
flow = Flow(
|
|
llm=llm,
|
|
max_loops=5,
|
|
)
|
|
|
|
out = flow.run("Generate a 10,000 word blog, say Stop when done")
|
|
print(out)
|
|
|
|
|
|
```
|
|
|
|
---
|
|
|
|
## Documentation
|
|
|
|
- For documentation, go here, [swarms.apac.ai](https://swarms.apac.ai)
|
|
|
|
|
|
## Focus
|
|
- We are radically devoted to creating outcomes that our users want, we believe this is only possible by focusing extensively on reliability, scalability, and agility.
|
|
- An Agent's purpose is to satisfy your wants and needs and so this is our only focus, we believe this is only possible by investing impeccable detail into agent structure design in other words gluing together an llm with tools and memory in a way that delights users and executes tasks exactly how users want them to be executed.
|
|
- The reliability of communication in a swarm is also extremely critical to your success and with this in mind we carefully craft and extensively test our structures.
|
|
|
|
- Reliability.
|
|
- Scalability.
|
|
- Speed.
|
|
- Power.
|
|
- Agile.
|
|
|
|
## Contribute
|
|
|
|
We're always looking for contributors to help us improve and expand this project. If you're interested, please check out our [Contributing Guidelines](CONTRIBUTING.md).
|
|
|
|
# License
|
|
|
|
MIT
|