SingleStore for Team

HackerNews team persists its sessions in SingleStore configured from environment variables.

This example’s source docstring names a removed cookbook path: cookbook/storage/singlestore_storage/singlestore_storage_for_team.py. Follow the generated Run step below.

singlestore_for_team.py

"""
1. Run: `uv pip install openai ddgs newspaper4k lxml_html_clean agno` to install the dependencies
2. Run: `python cookbook/storage/singlestore_storage/singlestore_storage_for_team.py` to run the team
"""

from os import getenv
from typing import List

from agno.agent import Agent
from agno.db.singlestore.singlestore import SingleStoreDb
from agno.models.openai import OpenAIChat
from agno.team import Team
from agno.tools.hackernews import HackerNewsTools
from agno.tools.websearch import WebSearchTools
from pydantic import BaseModel

# ---------------------------------------------------------------------------
# Setup
# ---------------------------------------------------------------------------
USERNAME = getenv("SINGLESTORE_USERNAME")
PASSWORD = getenv("SINGLESTORE_PASSWORD")
HOST = getenv("SINGLESTORE_HOST")
PORT = getenv("SINGLESTORE_PORT")
DATABASE = getenv("SINGLESTORE_DATABASE")
SSL_CERT = getenv("SINGLESTORE_SSL_CERT", None)

db_url = (
    f"mysql+pymysql://{USERNAME}:{PASSWORD}@{HOST}:{PORT}/{DATABASE}?charset=utf8mb4"
)
db = SingleStoreDb(db_url=db_url)


# ---------------------------------------------------------------------------
# Create Team
# ---------------------------------------------------------------------------
class Article(BaseModel):
    title: str
    summary: str
    reference_links: List[str]


hn_researcher = Agent(
    name="HackerNews Researcher",
    model=OpenAIChat("gpt-4o"),
    role="Gets top stories from hackernews.",
    tools=[HackerNewsTools()],
)

web_searcher = Agent(
    name="Web Searcher",
    model=OpenAIChat("gpt-4o"),
    role="Searches the web for information on a topic",
    tools=[WebSearchTools()],
    add_datetime_to_context=True,
)


hn_team = Team(
    name="HackerNews Team",
    model=OpenAIChat("gpt-4o"),
    members=[hn_researcher, web_searcher],
    db=db,
    instructions=[
        "First, search hackernews for what the user is asking about.",
        "Then, ask the web searcher to search for each story to get more information.",
        "Finally, provide a thoughtful and engaging summary.",
    ],
    output_schema=Article,
    markdown=True,
    show_members_responses=True,
)

# ---------------------------------------------------------------------------
# Run Team
# ---------------------------------------------------------------------------
if __name__ == "__main__":
    hn_team.print_response("Write an article about the top 2 stories on hackernews")

Run the Example

1. Set up your virtual environment

   Mac

   uv venv --python 3.12
   source .venv/bin/activate
   

   uv venv --python 3.12
   .venv\Scripts\activate
   
2. Install dependencies

   uv pip install -U agno ddgs openai pymysql sqlalchemy
   
3. Export environment variables

   Mac/Linux

   export OPENAI_API_KEY="your_openai_api_key_here"
   export SINGLESTORE_DATABASE="your_singlestore_database_here"
   export SINGLESTORE_HOST="your_singlestore_host_here"
   export SINGLESTORE_PASSWORD="your_singlestore_password_here"
   export SINGLESTORE_PORT="your_singlestore_port_here"
   export SINGLESTORE_USERNAME="your_singlestore_username_here"
   

   $Env:OPENAI_API_KEY="your_openai_api_key_here"
   $Env:SINGLESTORE_DATABASE="your_singlestore_database_here"
   $Env:SINGLESTORE_HOST="your_singlestore_host_here"
   $Env:SINGLESTORE_PASSWORD="your_singlestore_password_here"
   $Env:SINGLESTORE_PORT="your_singlestore_port_here"
   $Env:SINGLESTORE_USERNAME="your_singlestore_username_here"
   
4. Run the example

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

   python singlestore_for_team.py
   

Full source: cookbook/06_storage/singlestore/singlestore_for_team.py