Build multi-agent systems with OS reusable agents

This tutorial demonstrates how to build a coral multi-agent system for software testing using open source reusable agents from the awesome-agents-for-multi-agent-systems repo on GitHub.

So in this tutorial, we are going to go over a few things:

• Finding agents for your use case
• Running the agents on Coral server
• Having them all collaborate together

1. Choose your agents

We go over this step in the agent discovery part of our docs so you might want to look there if you have not but in short you can choose the agents you want to use for your multi-agent system from this repo: https://github.com/Coral-Protocol/awesome-agents-for-multi-agent-systems

2. Set them up on the Coral server

Now you have your agents, let’s run and set each of them up individually

Git clone agent

Clone & Install Dependencies

Clone the repository:

git clone https://github.com/Coral-Protocol/Coral-GitClone-Agent.git

Navigate to the project directory:

cd Coral-GitClone-Agent

Install uv:

pip install uv

Install dependencies from pyproject.toml using uv:

uv sync

This command will read the pyproject.toml file and install all specified dependencies in a virtual environment managed by uv.

Configure Environment Variables

Copy the example file and update it with your credentials:

cp .env.example .env

Required environment variables:

• OPENAI_API_KEY

• OPENAI_API_KEY: Sign up at platform.openai.com, go to “API Keys” under your account, and click “Create new secret key.”

Code diffs review agent

Clone & Install Dependencies

Clone the repository:

git clone https://github.com/Coral-Protocol/Coral-CodeDiffReview-Agent.git

Navigate to the project directory:

cd Coral-CodeDiffReview-Agent

Install uv:

pip install uv

Install dependencies from pyproject.toml using uv:

uv sync

This command will read the pyproject.toml file and install all specified dependencies in a virtual environment managed by uv.

Configure Environment Variables

Copy the example file and update it with your credentials:

cp .env.example .env

Required environment variables:

• OPENAI_API_KEY

• GROQ_API_KEY

• GITHUB_ACCESS_TOKEN

• OPENAI_API_KEY: Sign up at platform.openai.com, go to “API Keys” under your account, and click “Create new secret key.”

• GROQ_API_KEY: Register at groq.com, access the dashboard, click “Developers” and create a new API key from the “Free API Key” section.

• GITHUB_ACCESS_TOKEN: Log in to github.com, go to Settings → Developer settings → Personal access tokens, then “Generate new token,” select the required scopes, and copy the generated token.

Unit test runner agent

Clone & Install Dependencies

Clone the repository:

git clone https://github.com/Coral-Protocol/Coral-UnitTestRunner-Agent.git

Navigate to the project directory:

cd Coral-UnitTestRunner-Agent

Install uv:

pip install uv

Install dependencies from pyproject.toml using uv:

uv sync

This command will read the pyproject.toml file and install all specified dependencies in a virtual environment managed by uv.

Configure Environment Variables

Copy the example file and update it with your credentials:

cp .env.example .env

Required environment variables:

• OPENAI_API_KEY

• OPENAI_API_KEY: Sign up at platform.openai.com, go to “API Keys” under your account, and click “Create new secret key.”

Repo understanding agent

Clone & Install Dependencies

Clone the repository:

git clone https://github.com/Coral-Protocol/Coral-RepoUnderstanding-Agent.git

Navigate to the project directory:

cd Coral-RepoUnderstanding-Agent

Install uv:

pip install uv

Install dependencies from pyproject.toml using uv:

uv sync

This command will read the pyproject.toml file and install all specified dependencies in a virtual environment managed by uv.

Configure Environment Variables

Copy the example file and update it with your credentials:

cp .env.example .env

Required environment variables:

• OPENAI_API_KEY

• GITHUB_ACCESS_TOKEN

• OPENAI_API_KEY: Sign up at platform.openai.com, go to “API Keys” under your account, and click “Create new secret key.”

• GITHUB_ACCESS_TOKEN: Log in to github.com, go to Settings → Developer settings → Personal access tokens, then “Generate new token,” select the required scopes, and copy the generated token.

Repo unit test advisor agent

Clone & Install Dependencies

Clone the repository:

git clone https://github.com/Coral-Protocol/Coral-RepoUnitTestAdvisor-Agent.git

Navigate to the project directory:

cd Coral-RepoUnitTestAdvisor-Agent

Install uv:

pip install uv

Install dependencies from pyproject.toml using uv:

uv sync

This command will read the pyproject.toml file and install all specified dependencies in a virtual environment managed by uv.

Configure Environment Variables

Copy the example file and update it with your credentials:

cp .env.example .env

Required environment variables:

• OPENAI_API_KEY

• GITHUB_ACCESS_TOKEN

• OPENAI_API_KEY: Sign up at platform.openai.com, go to “API Keys” under your account, and click “Create new secret key.”

• GITHUB_ACCESS_TOKEN: Log in to github.com, go to Settings → Developer settings → Personal access tokens, then “Generate new token,” select the required scopes, and copy the generated token.

Repo doc consistency checker agent

Clone & Install Dependencies

Clone the repository:

git clone https://github.com/Coral-Protocol/Coral-RepoDocConsistencyChecker-Agent.git

Navigate to the project directory:

cd Coral-RepoDocConsistencyChecker-Agent

Install uv:

pip install uv

Install dependencies from pyproject.toml using uv:

uv sync

This command will read the pyproject.toml file and install all specified dependencies in a virtual environment managed by uv.

Configure Environment Variables

Copy the example file and update it with your credentials:

cp .env.example .env

Required environment variables:

• OPENAI_API_KEY

• GITHUB_ACCESS_TOKEN

• OPENAI_API_KEY: Sign up at platform.openai.com, go to “API Keys” under your account, and click “Create new secret key.”

• GITHUB_ACCESS_TOKEN: Log in to github.com, go to Settings → Developer settings → Personal access tokens, then “Generate new token,” select the required scopes, and copy the generated token.

3. Have your agents collaborate

3.1 Clone Coral Protocol and Interface Agent

First, clone required repositories:

git clone https://github.com/Coral-Protocol/coral-server.git
git clone https://github.com/Coral-Protocol/Coral-Interface-Agent.git

3.2 Set up Interface Agent

• Install Dependencies:

  Navigate to the project directory:

  cd Coral-Interface-Agent
  

  Install uv:

  pip install uv
  

  Install dependencies from pyproject.toml using uv:

  uv sync
  

3.3 Start the MCP Server

Navigate to the coral-server directory and run:

cd coral-server
./gradlew run

Note: Gradle may appear to stall at 83%, but the server is running. Check the terminal logs to confirm.

3.4 Run your chosen agents in separate terminals

For example, if you choose the Git clone agent, Code diffs review agent, and Repo unit test advisor agent, please run these three agents along with the Interface agent in four separate terminals:

# Terminal 1: Interface Agent
uv run 0-langchain-interface.py

# Terminal 2: GitClone Agent
uv run 1-crewai-GitCloneAgent.py

# Terminal 3: CodeDiffReview Agent
uv run 2-camel-CodeDiffReviewAgent.py

# Terminal 4: UnitTestRunner Agent
uv run 3-langchain-UnitTestRunnerAgent.py

---

Thank you

• For issues, please open a GitHub issue in the corresponding agent repository.

---