shared_state.py
"""
Shared State — Dojo Demo
=========================
Agent with session state that syncs with frontend.
Dojo expects state structure:
{
"recipe": {
"title": str,
"skill_level": "Beginner" | "Intermediate" | "Advanced",
"cooking_time": "5 min" | "15 min" | "30 min" | "45 min" | "60+ min",
"special_preferences": List[str], # "High Protein", "Low Carb", "Spicy", etc.
"ingredients": List[{icon: str, name: str, amount: str}],
"instructions": List[str]
}
}
The agent uses update_session_state tool to modify state, which triggers
STATE_DELTA events that the frontend uses to update the recipe UI.
"""
from agno.agent.agent import Agent
from agno.models.openai import OpenAIResponses
shared_state_agent = Agent(
name="shared_state",
model=OpenAIResponses(id="gpt-5.5"),
session_state={
"recipe": {
"title": "Make Your Recipe",
"skill_level": "Intermediate",
"cooking_time": "45 min",
"special_preferences": [],
"ingredients": [
{"icon": "🥕", "name": "Carrots", "amount": "3 large, grated"},
{"icon": "🌾", "name": "All-Purpose Flour", "amount": "2 cups"},
],
"instructions": ["Preheat oven to 350°F (175°C)"],
}
},
add_session_state_to_context=True,
enable_agentic_state=True,
instructions="""You are a recipe assistant. The current recipe state is shown in <session_state>.
Use update_session_state to modify the recipe. The structure is:
- title: Recipe name (string)
- skill_level: "Beginner", "Intermediate", or "Advanced"
- cooking_time: "5 min", "15 min", "30 min", "45 min", or "60+ min"
- special_preferences: List of strings like "High Protein", "Low Carb", "Spicy", "Budget-Friendly", "One-Pot Meal", "Vegetarian", "Vegan"
- ingredients: List of objects with {icon: emoji, name: string, amount: string}
- instructions: List of step strings
When modifying:
1. Read the current state from <session_state>
2. Use update_session_state with the fields you want to change
3. Preserve existing values for fields you don't change
Example: To add an ingredient, include the existing ingredients plus the new one.""",
markdown=True,
)
Run the Example
1
Set up your virtual environment
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[agui,os]" ddgs google-genai openai requests
3
Export your API keys
export GOOGLE_API_KEY="your_google_api_key_here"
export OPENAI_API_KEY="your_openai_api_key_here"
$Env:GOOGLE_API_KEY="your_google_api_key_here"
$Env:OPENAI_API_KEY="your_openai_api_key_here"
4
Clone Agno
Clone the repository and run the remaining commands from its root:
git clone https://github.com/agno-agi/agno.git
cd agno
5
Run the example
Run the example from the repository root:
python cookbook/05_agent_os/interfaces/agui/showcase.py