Quick Start

pip install functor-sdk

uv pip install functor-sdk

from functor_sdk import FunctorClient

client = FunctorClient(
    api_key="your-api-key",
    base_url="http://localhost:8000"  # Your Functor backend
)

from functor_sdk.tools import ToolRegistry

# Discover all tools from the memory namespace
registry = ToolRegistry()
tools = registry.discover(client.memory)

# See what tools are available
print(f"Found {len(tools)} tools")
for name, tool in list(tools.items())[:5]:
    print(f"  - {name}: {tool.description}")

Found 71 tools
  - functor_episodic_create: Create a new episodic memory entry
  - functor_episodic_search: Search episodic memories by query
  - functor_episodic_get: Get a specific episode by ID
  - functor_semantic_add_fact: Add a semantic fact to knowledge graph
  - functor_procedural_create: Create a new procedure

from functor_sdk.tools import FunctorToolContext
import asyncio

async def main():
    ctx = FunctorToolContext(client)

    # Store an episode
    result = await ctx.call("functor_episodic_create", {
        "session_id": "session-123",
        "event_type": "user_message",
        "content": "User asked about Python best practices",
        "metadata": {"topic": "programming"}
    })
    print(f"Created episode: {result}")

    # Search memories
    results = await ctx.call("functor_episodic_search", {
        "query": "Python programming",
        "limit": 5
    })
    print(f"Found {len(results)} matching episodes")

asyncio.run(main())

functor_{namespace}_{method}

Examples:
  functor_episodic_create     → client.memory.episodic.create_async()
  functor_semantic_add_fact   → client.memory.semantic.add_fact_async()
  functor_procedural_execute  → client.memory.procedural.execute_async()