v1.0.0 (Agno) (#1938)

[dirkbrnd]

Changelog

This is a major refactor to be coupled with the launch of Agno.

Interface Changes:

• phi.model.x → agno.models.x

• phi.knowledge_base.x → agno.knowledge.x (applies to all knowledge bases)

• phi.document.reader.xxx → agno.document.reader.xxx_reader (applies to all document readers)

• All Agno toolkits are now suffixed with Tools. E.g. DuckDuckGo → DuckDuckGoTools

• Multi-modal interface updates:

  • agent.run(images=[]) and agent.print_response(images=[]) is now of type Image

    class Image(BaseModel):
        url: Optional[str] = None  # Remote location for image
        filepath: Optional[Union[Path, str]] = None  # Absolute local location for image
        content: Optional[Any] = None  # Actual image bytes content
        detail: Optional[str] = None # low, medium, high or auto (per OpenAI spec https://platform.openai.com/docs/guides/vision?lang=node#low-or-high-fidelity-image-understanding) 
        id: Optional[str] = None

  • agent.run(audio=[]) and agent.print_response(audio=[]) is now of type Audio

    class Audio(BaseModel):
        filepath: Optional[Union[Path, str]] = None  # Absolute local location for audio
        content: Optional[Any] = None  # Actual audio bytes content
        format: Optional[str] = None

  • agent.run(video=[]) and agent.print_response(video=[]) is now of type Video

    class Video(BaseModel):
        filepath: Optional[Union[Path, str]] = None  # Absolute local location for video
        content: Optional[Any] = None  # Actual video bytes content

  • RunResponse.images is now a list of type ImageArtifact

    class ImageArtifact(Media):
        id: str
        url: str  # Remote location for file
        alt_text: Optional[str] = None

  • RunResponse.audio is now a list of type AudioArtifact

    class AudioArtifact(Media):
        id: str
        url: Optional[str] = None  # Remote location for file
        base64_audio: Optional[str] = None  # Base64-encoded audio data
        length: Optional[str] = None
        mime_type: Optional[str] = None

  • RunResponse.videos is now a list of type VideoArtifact

    class VideoArtifact(Media):
        id: str
        url: str  # Remote location for file
        eta: Optional[str] = None
        length: Optional[str] = None

  • RunResponse.response_audio is now of type AudioOutput

    class AudioOutput(BaseModel):
        id: str
        content: str  # Base64 encoded
        expires_at: int
        transcript: str

• Models:

  • Hermes → OllamaHermes
  • AzureOpenAIChat → AzureOpenAI
  • CohereChat → Cohere
  • DeepSeekChat → DeepSeek
  • GeminiOpenAIChat → GeminiOpenAI
  • HuggingFaceChat → HuggingFace

• Embedders now all take id instead of model as a parameter. For example

  db_url = "postgresql+psycopg://ai:ai@localhost:5532/ai"
  
  knowledge_base = PDFUrlKnowledgeBase(
      urls=["https://phi-public.s3.amazonaws.com/recipes/ThaiRecipes.pdf"],
      vector_db=PgVector(
          table_name="recipes",
          db_url=db_url,
          embedder=OllamaEmbedder(id="llama3.2", dimensions=3072),
      ),
  )
  knowledge_base.load(recreate=True)

• Agent Storage class

  • PgAgentStorage → PostgresAgentStorage
  • SqlAgentStorage → SqliteAgentStorage
  • MongoAgentStorage → MongoDbAgentStorage
  • S2AgentStorage → SingleStoreAgentStorage

• Workflow Storage class

  • SqlWorkflowStorage → SqliteWorkflowStorage
  • PgWorkflowStorage → PostgresWorkflowStorage
  • MongoWorkflowStorage → MongoDbWorkflowStorage

• Knowledge Base

  • phi.knowledge.pdf.PDFUrlKnowledgeBase → agno.knowledge.pdf_url.PDFUrlKnowledgeBase
  • phi.knowledge.csv.CSVUrlKnowledgeBase → agno.knowledge.csv_url.CSVUrlKnowledgeBase

• Readers

  • phi.document.reader.arxiv → agno.document.reader.arxiv_reader
  • phi.document.reader.docx → agno.document.reader.docx_reader
  • phi.document.reader.json → agno.document.reader.json_reader
  • phi.document.reader.pdf → agno.document.reader.pdf_reader
  • phi.document.reader.s3.pdf → agno.document.reader.s3.pdf_reader
  • phi.document.reader.s3.text → agno.document.reader.s3.text_reader
  • phi.document.reader.text → agno.document.reader.text_reader
  • phi.document.reader.website → agno.document.reader.website_reader

Improvements:

• Dataclasses - Changed various instances of Pydantic models to dataclasses to improve the speed.

Removals

• Removed all references to Assistant
• Removed all references to llm
• Removed the PhiTools tool
• Removed the PythonAgent and DuckDbAgent (this will be brought back in future with more specific agents)

Bug Fixes:

• Fixed semantic chunking by replacing similarity_threshold param with threshold param

New Features

• Introducing Evals to measure the performance, accuracy, and reliability of your Agents

---

This discussion was created from the release v1.0.0: Release 1.0.0 (Agno) (#1938).