Welcome to motleycrew, your ultimate framework for building multi-agent AI systems. With motleycrew, you can seamlessly mix and match AI agents and tools from popular frameworks, design advanced workflows, and leverage dynamic knowledge graphs — all with simplicity and elegance.
Think of motleycrew as a conductor that orchestrates a symphony of AI agents and tools. It provides building blocks for creating AI systems, enabling you to focus on the high-level design while motleycrew takes care of the rest.
See our quickstart page for an overview of the framework and its capabilities.
pip install motleycrew
To get you started, here's a simple example of how to create a crew with two agents: a writer and an illustrator. The writer will write a short article, and the illustrator will illustrate it.
from motleycrew import MotleyCrew
from motleycrew.agents.langchain import ReActToolCallingAgent
from motleycrew.tasks import SimpleTask
from motleycrew.tools.image.dall_e import DallEImageGeneratorTool
from langchain_community.tools import DuckDuckGoSearchRun
crew = MotleyCrew()
writer = ReActToolCallingAgent(name="writer", tools=[DuckDuckGoSearchRun()])
illustrator = ReActToolCallingAgent(name="illustrator", tools=[DallEImageGeneratorTool()])
write_task = SimpleTask(
crew=crew, agent=writer, description="Write a short article about latest AI advancements"
)
illustrate_task = SimpleTask(
crew=crew, agent=illustrator, description="Illustrate the given article"
)
write_task >> illustrate_task
crew.run()
print(write_task.output)
print(illustrate_task.output)
Here, we have a chain of two consecutive tasks. A SimpleTask basically just contains a prompt and an agent that will execute it. The >>
operator is used to chain tasks together.
If you want to learn more about creating flows in such fashion, see our blog with images example.
Under the hood, the tasks are stored in a knowledge graph, as well as all the data needed for their execution. You can create custom tasks that utilize the knowledge graph in any way you want. The graph can be used to control the flow of your system, or simply as a universal data store.
Please read our docs on key concepts and API to learn more about creating custom tasks and using the knowledge graph. Also, see how it all comes alive in the research agent example.
We provide a universal HTTP caching tool, motleycache, also available as a separate package. It can cache all HTTP requests made by your agents, including LLM and tool calls, out of the box. This is especially useful for debugging and testing.
Motleycrew also comes with support for Lunary, an open-source observability platform. You can use it to monitor your agents' performance, visualize the flow of your system, and more.
To learn more about these features, see our caching and observability docs.
We have a small but growing collection of examples in our documentation.
We have a community Discord server where you can ask questions, share your ideas, and get help with your projects.
If you find a bug or have a feature request, feel free to open an issue in this repository. Contributions of any kind are also welcome!