We have built a few examples to showcase Nexus agents.
Before you can use the examples or build your own agents, you need to install a few things first, as shown in the next section.
We support macOS, windows and linux.
You need to install the following tools by following their official installation instructions:
dockerjust(on Linux install it with "Pre-Built Binaries" rather than withaptbecause of an outdated version)python
We use just as a general command runner, just run just for available commands.
We use Docker to create a consistent local environment for all examples, ensuring compatibility across macOS, Windows, and Linux. By packaging dependencies into isolated containers, we aim to provide a uniform environment that minimizes compatibility issues. To run these examples, you’ll need Docker Compose version 2.20 or higher.
Note for macOS users: While Ollama can run in a container on macOS, it experiences poor performance due to Docker Desktop for macOS lacking GPU acceleration support. To ensure better performance, Ollama is running directly on the host instead of within a container.
This example demonstrates how to create an Instagram post planner agent using the Nexus SDK.
Run with just example ig-post-planner.
This example demonstrates how to create a trip planner agent using the Nexus SDK.
Run with just example trip-planner.
This example prompts the user to create a cluster by describing agents and tasks on the command line.
Run with just example cli-cluster.
Agents can use tools to enhance their capabilities. Please refer to the tools README
for a list of available tools, and instructions on how to add new ones.
Events allow offchain systems to respond to onchain actions, automating tool execution and model inference based on specific triggers. Please refer to the events README for more details.