Skip to main content
The Registry manages non-serializable components (tools, models, databases, schemas, functions) that Studio depends on.
from agno.db.postgres import PostgresDb
from agno.models.openai import OpenAIChat
from agno.models.anthropic import Claude
from agno.os import AgentOS
from agno.registry import Registry
from agno.tools.calculator import CalculatorTools
from agno.tools.websearch import WebSearchTools
from agno.vectordb.pgvector import PgVector
from pydantic import BaseModel

class InputSchema(BaseModel):
    input: str
    description: str

def custom_evaluator(input: str) -> bool:
    return "urgent" in input.lower()

db = PostgresDb(db_url="postgresql+psycopg://ai:ai@localhost:5532/ai", id="postgres_db")

registry = Registry(
    name="My Registry",
    tools=[CalculatorTools(), WebSearchTools()],
    models=[OpenAIChat(id="gpt-5-mini"), Claude(id="claude-sonnet-4-5")],
    dbs=[db],
    vector_dbs=[PgVector(db_url="postgresql+psycopg://ai:ai@localhost:5532/ai", table_name="embeddings")],
    schemas=[InputSchema],
    functions=[custom_evaluator],
)

agent_os = AgentOS(id="my-app", registry=registry, db=db)
app = agent_os.get_app()

Component Types

TypeFieldDescription
ToolstoolsToolkit instances, Function objects, or plain callables
ModelsmodelsModel provider instances (OpenAI, Anthropic, etc.)
DatabasesdbsBaseDb instances for storage
Vector DBsvector_dbsVectorDb instances for knowledge bases
SchemasschemasPydantic BaseModel subclasses for structured I/O
FunctionsfunctionsPython callables used as workflow evaluators, selectors, or executors

Registry API

The registry exposes a GET /registry endpoint through AgentOS with filtering and pagination.

Query Parameters

ParameterTypeDefaultDescription
component_typestringNoneFilter by type: TOOL, MODEL, DB, VECTOR_DB, SCHEMA, FUNCTION
namestringNonePartial name match (case-insensitive)
pageint1Page number
limitint20Items per page (1-100)

Response Metadata

Each component in the response includes type-specific metadata:
Component TypeMetadata Fields
Toolclass_path, parameters, signature, toolkit functions
Modelprovider, model_id
Databasedb_id
Vector DBcollection, table_name
SchemaJSON schema definition
Functionsignature, parameters

Developer Resources