> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Knowledge

> Upload, monitor, search, and delete AgentOS knowledge content.

```python knowledge.py theme={null}
"""Upload, monitor, search, and delete AgentOS knowledge content.

Upload processing is asynchronous, so this example polls the concrete
content-status endpoint before listing and searching.

Prerequisites: start ``_server.py`` and set OPENAI_API_KEY.
Run: .venvs/demo/bin/python cookbook/05_agent_os/03_python_client/04_knowledge.py
Try: watch processing move from processing to completed before search runs.
"""

import asyncio

from agno.client import AgentOSClient
from agno.os.routers.knowledge.schemas import ContentStatus

BASE_URL = "http://localhost:7778"


# ---------------------------------------------------------------------------
# Create the Client
# ---------------------------------------------------------------------------


async def wait_until_processed(client: AgentOSClient, content_id: str) -> ContentStatus:
    """Poll an uploaded content item until processing reaches a terminal state."""
    for _ in range(60):
        status = await client.get_knowledge_content_status(content_id)
        print(f"Content status: {status.status.value}")
        if status.status is ContentStatus.COMPLETED:
            return status.status
        if status.status is ContentStatus.FAILED:
            raise RuntimeError(status.status_message or "Knowledge processing failed")
        await asyncio.sleep(0.5)
    raise TimeoutError("Knowledge content did not finish processing")


async def manage_knowledge() -> None:
    """Exercise the full knowledge content lifecycle."""
    client = AgentOSClient(base_url=BASE_URL)

    uploaded = await client.upload_knowledge_content(
        name="Python client notes",
        description="Small document uploaded by the Python client cookbook.",
        text_content=(
            "AgentOS exposes agents, teams, workflows, sessions, memory, "
            "knowledge, and evaluations through one HTTP API."
        ),
        metadata={"source": "03_python_client"},
    )
    print(f"Upload accepted: {uploaded.id}")

    await wait_until_processed(client, uploaded.id)

    content = await client.list_knowledge_content()
    print(f"Knowledge items: {len(content.data)}")

    results = await client.search_knowledge(
        query="What does AgentOS expose?",
        limit=5,
    )
    print(f"Search results: {len(results.data)}")
    for result in results.data:
        print(f"- {result.content}")
        if result.reranking_score is not None:
            print(f"  Reranking score: {result.reranking_score}")

    deleted = await client.delete_knowledge_content(uploaded.id)
    print(f"Deleted content: {deleted.id}")


# ---------------------------------------------------------------------------
# Run the Example
# ---------------------------------------------------------------------------

if __name__ == "__main__":
    asyncio.run(manage_knowledge())
```

## Run the Example

<Steps>
  <Snippet file="create-venv-step.mdx" />

  <Step title="Install dependencies">
    ```bash theme={null}
    uv pip install -U "agno[os]" chromadb openai
    ```
  </Step>

  <Step title="Export your API keys">
    <CodeGroup>
      ```bash Mac/Linux theme={null}
      export OPENAI_API_KEY="your_openai_api_key_here"
      ```

      ```bash Windows theme={null}
      $Env:OPENAI_API_KEY="your_openai_api_key_here"
      ```
    </CodeGroup>
  </Step>

  <Step title="Clone Agno">
    Clone the pinned Agno source and run the remaining commands from its root:

    ```bash theme={null}
    git clone https://github.com/agno-agi/agno.git
    cd agno
    git checkout v3.0.4
    ```
  </Step>

  <Step title="Start the AgentOS server">
    Open another terminal in the parent directory where `.venv` and the cloned `agno` directory are siblings, then start the shared server on port 7778:

    <CodeGroup>
      ```bash Mac/Linux theme={null}
      source .venv/bin/activate
      export OPENAI_API_KEY="your_openai_api_key_here"
      cd agno
      python cookbook/05_agent_os/03_python_client/_server.py
      ```

      ```powershell Windows theme={null}
      .venv\Scripts\activate
      $Env:OPENAI_API_KEY="your_openai_api_key_here"
      Set-Location agno
      python cookbook/05_agent_os/03_python_client/_server.py
      ```
    </CodeGroup>
  </Step>

  <Step title="Run the example">
    Run the example from the repository root:

    ```bash theme={null}
    python cookbook/05_agent_os/03_python_client/04_knowledge.py
    ```
  </Step>
</Steps>

Full source: [cookbook/05\_agent\_os/03\_python\_client/04\_knowledge.py](https://github.com/agno-agi/agno/blob/v3.0.4/cookbook/05_agent_os/03_python_client/04_knowledge.py)