Async Agent with Tools

Run a Nexus agent with WebSearchTools asynchronously.

Code

tool_use.py

"""Run `uv pip install ddgs` to install dependencies."""

import asyncio

from agno.agent import Agent
from agno.models.nexus import Nexus
from agno.tools.websearch import WebSearchTools

agent = Agent(
    model=Nexus(id="anthropic/claude-sonnet-4-6"),
    tools=[WebSearchTools()],
    markdown=True,
)

asyncio.run(agent.aprint_response("Whats happening in France?"))

Usage

1. Set up your virtual environment

   Mac

   uv venv --python 3.12
   source .venv/bin/activate
   
2. Set your API keys

   export OPENAI_API_KEY=xxx
   export ANTHROPIC_API_KEY=xxx
   
3. Install dependencies

   uv pip install -U agno openai ddgs
   
4. Configure Nexus

   Install Nexus, then create nexus.toml in the directory where you will start the gateway:

   [server]
   listen_address = "127.0.0.1:8000"
   
   [llm]
   enabled = true
   
   [llm.protocols.openai]
   enabled = true
   path = "/llm"
   
   [llm.providers.anthropic]
   type = "anthropic"
   api_key = "{{ env.ANTHROPIC_API_KEY }}"
   
   [llm.providers.anthropic.models."claude-sonnet-4-6"]
   

   The Nexus model sends OpenAI-compatible requests to http://localhost:8000/llm/v1/ by default. Nexus requires every model to be declared in nexus.toml.

5. Start Nexus

   Start the gateway from the directory that contains nexus.toml:

   nexus
   
6. Run Agent

   Save the code above as tool_use.py, then run:

   python tool_use.py