pip install feral-sdk

from feral_sdk import FeralClient

async with FeralClient("http://localhost:9090") as client:
    # Health check
    health = await client.health()

    # Chat
    reply = await client.chat("Summarize my last meeting notes")
    print(reply)

    # Dashboard data
    dashboard = await client.get_dashboard()
    print(dashboard["skills_count"])

    # Memory search
    results = await client.search_memory("project deadlines")

    # List skills
    skills = await client.list_skills()

    # Create a memory note
    await client.create_note("Deploy to staging by Friday", tags=["work"])

    # Invoke a skill directly
    data = await client.invoke_skill("weather", "current", {"city": "Berlin"})

FeralClient(base_url: str = "http://localhost:9090")

from feral_sdk import FeralPlugin, feral_tool

class WeatherPlugin(FeralPlugin):
    name = "weather"
    description = "Real-time weather data"
    version = "0.1.0"

    @feral_tool(description="Get current weather for a city")
    async def current(self, city: str) -> dict:
        return {"city": city, "temp_f": 72, "condition": "sunny"}

    @feral_tool(description="Get 5-day forecast")
    async def forecast(self, city: str) -> dict:
        return {"city": city, "days": 5, "forecast": ["sunny", "cloudy", "rain", "sunny", "sunny"]}

@feral_tool(
    description="Human-readable description for the LLM",
    name="optional_override",          # defaults to method name
    parameters={"city": {"type": "string", "description": "City name"}},
)
async def my_tool(self, city: str) -> dict:
    ...

from feral_sdk import HUPDevice

class WristbandAdapter(HUPDevice):
    device_type = "wearable"
    device_name = "Feral Wristband"
    capabilities = ["heart_rate", "spo2", "skin_temp"]
    telemetry_interval_s = 5.0

    async def read_telemetry(self) -> dict:
        return {"heart_rate": 72, "spo2": 98, "skin_temp_c": 36.5}

    async def execute_action(self, action: str, params: dict) -> dict:
        if action == "vibrate":
            return {"ok": True}
        return {"error": f"Unknown action: {action}"}

import asyncio
adapter = WristbandAdapter()
asyncio.run(adapter.run("ws://localhost:9090/v1/daemon"))