Basic State

Create an agent with basic session state that keeps a shopping list across interactions, stored in SQLite.

1. Create a Python file

   session_state_basic.py

   from agno.agent import Agent
   from agno.db.sqlite import SqliteDb
   from agno.models.openai import OpenAIResponses
   from agno.run import RunContext
   
   
   def add_item(run_context: RunContext, item: str) -> str:
       """Add an item to the shopping list."""
       if run_context.session_state is None:
           run_context.session_state = {}
   
       run_context.session_state["shopping_list"].append(item)
       return f"The shopping list is now {run_context.session_state['shopping_list']}"
   
   
   agent = Agent(
       model=OpenAIResponses(id="gpt-5.2"),
       session_state={"shopping_list": []},
       db=SqliteDb(db_file="tmp/agents.db"),
       tools=[add_item],
       instructions="Current state (shopping list) is: {shopping_list}",
       markdown=True,
   )
   
   agent.print_response("Add milk, eggs, and bread to the shopping list", stream=True)
   print(f"Final session state: {agent.get_session_state()}")
   
2. Set up your virtual environment

   Mac

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

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

   uv pip install -U agno openai sqlalchemy
   
4. Export your OpenAI API key

   Set OpenAI Key

   Set your OPENAI_API_KEY as an environment variable. You can get one from OpenAI.

   Mac

   export OPENAI_API_KEY=sk-***
   

   setx OPENAI_API_KEY sk-***
   
5. Run Agent

   python session_state_basic.py