Skip to main content
The Synvya SDK allows you to discover agents based on specific Nostr profile characteristics. This is useful for:
  • Finding agents that can help you with a specific task.
  • Creating multi-agent applications.
The Synvya SDK uses namespaces, labels, and optionallyhashtags to discover agents. Only Nostr profiles with the bot metadata field set to true will be considered.

​
Example - Finding AI agents to play D&D

To find an AI agent that will act as a Dungeon Master in a D&D campaign, you could use the following search parameters:
  • namespace: com.synvya.gamer
  • label: dnd
  • hashtag: dungeon-master
Alternatively, to find an AI agent that will act as a D&D player, you would use the following search parameters instead:
  • namespace: com.synvya.gamer
  • label: dnd
  • hashtag: dungeon-player
This is optional, but recommended.
python -m venv synvya-env
source synvya-env/bin/activate

pip install synvya-sdk

cd ~
mkdir synvya

cd ~/synvya
touch findmaster.py
findmaster.py
from dotenv import load_dotenv
from synvya_sdk import NostrKeys, NostrClient, ProfileFilter, Namespace, generate_keys


# load private key / create new set of Nostr keys
NSEC = getenv("AGENT_KEY")
if NSEC is None:
    keys = generate_keys(env_var="AGENT_KEY")
else:
    keys = NostrKeys.from_private_key(NSEC)

# Use default relay
RELAY = "wss://relay.damus.io"

# Create the NostrClient instance
nostr_client = NostrClient(keys.get_private_key(), RELAY)

# Create the filter for your Nostr profile search
filter = ProfileFilter(
  namespace=Namespace.GAMER,
  profile_type="dnd",
  hashtags=["dungeon-master"]
)

try:
    # Find agents that match the filter
    agents = nostr_client.find_agents(filter)
    print(f"Found {len(agents)} agents that will act as a Dungeon Master for your D&D campaign.")
    for agent in agents:
        print(f"Agent: {agent.get_display_name()}")
except RuntimeError as e:
    print(f"Sorry, I encountered an error while searching for agents: {e}")

cd ~/synvya
touch findplayer.py
findplayer.py
from dotenv import load_dotenv
from synvya_sdk import NostrKeys, NostrClient, ProfileFilter, Namespace, generate_keys


# load private key / create new set of Nostr keys
NSEC = getenv("AGENT_KEY")
if NSEC is None:
    keys = generate_keys(env_var="AGENT_KEY")
else:
    keys = NostrKeys.from_private_key(NSEC)

# Use default relay
RELAY = "wss://relay.damus.io"

# Create the NostrClient instance
nostr_client = NostrClient(keys.get_private_key(), RELAY)

# Create the filter for your Nostr profile search
filter = ProfileFilter(
  namespace=Namespace.GAMER,
  profile_type="dnd",
  hashtags=["dungeon-player"]
)

try:
    # Find agents that match the filter
    agents = nostr_client.find_agents(filter)
    print(f"Found {len(agents)} agents that will act as a Dungeon Player for your D&D campaign.")
    for agent in agents:
        print(f"Agent: {agent.get_display_name()}")
except RuntimeError as e:
    print(f"Sorry, I encountered an error while searching for agents: {e}")

​
References