with_filesystem.py
Run the Example
1
Set up your virtual environment
2
Install dependencies
3
Export your OpenAI API key
4
Run PgVector
5
Run the example
Save the code above as
with_filesystem.py, then run:Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
The point of the manual door: LearningMachine, FileSystem and your own system prompt compose in one order you can read off the page.
"""
Composition: LearningMachine + FileSystem, One Deliberate Order
===============================================================
The point of the manual door: LearningMachine, FileSystem and your own
system prompt compose in one order you can read off the page. Nothing is
attached behind your back.
Run:
.venvs/demo/bin/python cookbook/08_learning/11_composition/with_filesystem.py
"""
from agno.agent import Agent
from agno.db.postgres import PostgresDb
from agno.fs import FileSystem
from agno.learn import LearningMachine, LearningMode, UserMemoryConfig
from agno.models.openai import OpenAIResponses
db = PostgresDb(db_url="postgresql+psycopg://ai:ai@localhost:5532/ai")
learning = LearningMachine(
db=db,
model=OpenAIResponses(id="gpt-5.5"), # the manual door injects nothing
user_memory=UserMemoryConfig(mode=LearningMode.AGENTIC),
)
fs = FileSystem(db, namespace="composition-notes")
USER_ID = "composer@example.com"
agent = Agent(
model=OpenAIResponses(id="gpt-5.5"),
db=db,
tools=[*learning.get_tools(user_id=USER_ID), fs.tools()],
instructions=[
"You are a research assistant. Keep running notes on topics you research.",
learning.instructions(),
fs.instructions(),
],
user_id=USER_ID,
markdown=True,
)
if __name__ == "__main__":
agent.print_response(
"Note down: the vector-db comparison is due Friday. And remember that "
"I want conclusions first in every summary.",
stream=True,
)
print("\n--- files ---")
for f in fs.list():
print(f.path)
Set up your virtual environment
uv venv --python 3.12
source .venv/bin/activate
uv venv --python 3.12
.venv\Scripts\activate
Install dependencies
uv pip install -U agno "psycopg[binary]" openai sqlalchemy
Export your OpenAI API key
export OPENAI_API_KEY="your_openai_api_key_here"
$Env:OPENAI_API_KEY="your_openai_api_key_here"
Run PgVector
docker run -d \
-e POSTGRES_DB=ai \
-e POSTGRES_USER=ai \
-e POSTGRES_PASSWORD=ai \
-e PGDATA=/var/lib/postgresql \
-v pgvolume:/var/lib/postgresql \
-p 5532:5432 \
--name pgvector \
agnohq/pgvector:18
docker run -d `
-e POSTGRES_DB=ai `
-e POSTGRES_USER=ai `
-e POSTGRES_PASSWORD=ai `
-e PGDATA=/var/lib/postgresql `
-v pgvolume:/var/lib/postgresql `
-p 5532:5432 `
--name pgvector `
agnohq/pgvector:18
Run the example
with_filesystem.py, then run:python with_filesystem.py
Was this page helpful?